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ME?U5 MTROXJCriON 

SECTION 1 
IMRODUCriON 



NEW BOOKS 



IBMS/QUERY Reference Guide (IDR 4607) 

This book is a progratniter • s guide to EBMS/QUERY, vdiidi is the Data Base 
Management System query language and report writer. The query language 
lets a user retrieve information from a data base without having to 
write application programs. The report writer lets you format the 
retrieved information in very special ways. This manual describes 
every user-level ooramEind. Also described are possible additions that 
you might have to make to a subschana so that complex EB^SS data 
structures can be accessed by QUERY, As this book is a reference 
guide, it assumes you alrea<^ know how to use QUERY. 



EBMS/gJERY user's Guide (IDR4608) 

The EBMS/ffJERY User's Guide is a tutorial e35>lantion of the DBMS query 
language a.id report writer. After reading this book, you will know how 
to use all of the fundamental and most of the advanced QUERY commands. 
The book contains many examples that illustrate how to retrieve 
information and how tiiis retrieved information can be displayed. This 
book does not assume that the reader is a programmer. 



FED user's Guide (IDR4940) 

The Forms Editca:, FED, is an interactive program for designing forms 
that is usable by non-programmers. This book describes those areas of 
forms managanent about which a forms designer may wish to confer with a 
Systems Administrator and/or ^plications programmer; describes the 
actual procedures for using FED; and provides a practical example in 
designing a form and includes screen pictures that illustrate using 
FED. 
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SECTION 2 
SYSTEM ADMINISTRATOR 



THE SYSTEM ADMINISTRATOR'S GOIDE - H)R3109 



General Note 



Be sure to check the INFO UFD en the master disk for detailed 
installation information. 



Cnange to the Table of Snarea Segnents on Page j-j 

The table curraitly reads: 

2100-2177 Reserved for Prime 

The table should read: 

2100-2167 Reserved for Prime 
2170-2177 Reserved for oust oners 



New Option -LOWEND 

Add the following to page 7-6: 

A new option, -LOWEND, has been added to (X)PY_DISK to provide faster 
performance on models other than the 750 and 850. An example of a 
GOPYJDISK request using this option would be: 

OOPy_DISK -107ERIFY -LOWEND 



Changes and Additions to Printer Support 

Add the following to page 8-10: 

SPOCL now uses the Electronic Vertical Format Unit (EVFU) in the 300 
1pm printer/plotter to define the form length. The forms-length switch 
is no longer necessary in this device. 

The EVFU is enabled ty issuing the PROP subcoranand, "EVFU CN", when 
creating or modifying a printer environment. A subsequent cranmand, 
"PROP name - START" loads the EVFU into the printer as it starts it. 
If the power to the printer goes off, the EVFU must be reloaded ty 
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stopping and restarting the printer using PRIO. 

SEOCL now supports the new "band" printer. This printer uses an EVFU 
to determine the form length, so its environments must always have EVFU 
turned on. The EEVICE parameter may be prO, prl, pr2, or pr3. 

Since the format of the EVFU is differ oit from the one in the 300 Ipn 
printer/plotter, these two devices must be distinguished. A new 
environment paraneter called TiflPE has been defined for this purpose. 
Tte band printer is TYPE 1 and the printer/plotter is TYPE 0. 

850 Halt Handling 

Add to Handling Halts Under PRIMPS cm page 10-2: 

Step 1; On the 850 

As the 850 contains two instruction streams, it is first necessary to 
determine which stream caused the halt. This is done via VCP an the 
ai^jervisor terminal fcy typing: 

A 4/176106 <cr> 

If the number displayed is '41004, stream #1 is halted and the correct 
halt address is given in the "Halted at xxxjcj'yyy" message. 

If the number displ^ed is '120010, stream #2 is halted and its 
registers must be examined. This is done via VCP on the supervisor 
terminal ty typing: 

A 4/176400 <cr> 
A 7 <cr> 

The correct halt address is given in the "Slave Halted at xxxjc^yyy" 
message. 

F77 Optimization Defaults 

Add to Defaults Set by Driver Programs on page 14-1: 

Note 

Any level of optimization may be set to be the site default ty using 
the distributed program F77DF in the UFD F77>T0CLS. These values are 
stored in the driver file called F77DATA in the systan UFD SYSOVL. 
This file also stores the error messages returned vrfien compilation 
errors occur. 
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FM II ADDISK Command 

M3 the following to page 16-2: 

The ADDISK coniraand for FAM II systems is different from the ADDISK 
cxmnnand used on FM I systems. The FAM II cxaiiinand has the format: 

ADdisk -CN nodename packnamel packname2....packname9 

nodename The netwcark node name for a valid FAM II system. The node 
must be FAM II enabled (see NETCFG) . 

packname-n The name of the remote partition. FAM II does not use 
device numbers. 

Unlike FAM I, FAM II does not require that the remote system is up, or 
that the remote disk is started. The FAM II ADDISK conraand adds the 
di^ and system name to the search list displayed fcy the STKP DISK 
command. The status of the disk is checked whenever a user attempts to 
access the remote disk. 

Caution on Dse of LWCRD 

Add the following note to Reverse Channel Protocol on Pa^ 16-6: 

The reverse channel protocol is intended as an alternative to the 
XCN/XOFF protocol. Since both protocols use the same stop bit, i.e. 
bit 4 of the IMI?D, they must not be used together in the same mORD. 

Increase in Nimiber of AMLC Boards 

Change page 16-7, to reflect the following: 

The number of AMLC boards that a single configuration can si^jport has 
been changed from four to eight. 



Changing the Size of the EHQ Buffer 

Add the following note to DMQ-Size Option of AMIBUF Command on page 
17-3: 

To change the size of the DMQ buffer on an assignable line, use the 
actual line number. 
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Ccaif iguration Directive AMLIBL 

Add the following to page 17-4: 

Ccaif iguration directive MLIBL defines the size of the EMC input tumble 
tables at cold start. AMLIBL explicitly sets the size of the input 
buffers or automatically allocates the maximum size allowed by the 
available buffer space. The syntax is: 

AMLIBL buffer-size 

buffer-size is an octal number which represents the number of words 
allocated to each input buffer. There are two buffers for each AMLC 
controller and all buffers are made the same size. Except for the 
special value of zero described below, the number must be greater than 
'20. The upper bound is variable depending on the number of 
controllers configured and the amount of space available in the systan 
for buffers. If buffer-size is zero or emitted, the size of the 
buffers is automatically calculated as the maximum possible. If the 
AMLIBL directive is not specified, the default buffer size is 60 octal. 

If buffer-size is too small, the error message: 

BAD AMLIBL PARAMETEK (CINIT) 

will ge generated during cold start initialization. If buffer-size is 
too large, the error message: 

INPUT BUFFERS TOO LARGE (AMINIT) 

is generated at cold start initialization. The user should modify the 
parameter to be a value within the permissible range as described 
above. 



Default Value Changes 

In Filunt Direction on page 17-7 the default values should be 18 {'22) , 
127('177), and 2048('4000). 



NAMLC Ccaif iguration Directive Change 
On page 17-9, add to the NAMLC configuration directive: 
NAMLC + NTUSR must be less than or equal to octal '177. 

Configuration Directive NELUSR 

Add the following to page 17-10: 

Each user accessing files on your systan from ranote systems will 
require a slave process for the duration of the access. These slave 
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processes cx>me out of the ERIMDS 128 process pool. Coifiguration 
directive NSLUSR defines slave processes. NajUSR sets the number of 
slaves configured for a system. The syntax is: 

NSLUSR number 

number is the number of simultaneous ranote file accesses your system 
wishes to support. If this pool is exhausted when a ranote user makes 
an attach request, the E$NSLA (no NPX slaves available) error code is 
returned. 

Note 

NTUay-NPUSRfNBUSRfNSLUSR must be less than 129. 



Change to NKJSR configuration directive 

Change page 17-11 to show that the number of terminal users specified 
can now be a positive octal integer between 2 and 200 instead of 2 and 



Assignment of Paging Device Records 

Add the following to page 20-6: 

At Rev 18,2, paging device records are assigned in blocks of 8 pages at 
a time, rather than in blocks of 64 pages (or one segment) . 

Since user segments are often only 25% to 50 % full, a Rev, 18,2 
systan m^ be able to handle twice as many segtients as a Rev. 17 or 
Rev. 18.1 systan on the same amount of paging space. For tiiis reason, 
the formula given on page 20-5 for calculating the number of records 
needed on the paging device (pagdev) now represents the neximum number 
of records needed. A given system may function well with anyv^ere 
between 50% to 100% of this number of records. Therefore, systems on 
which disk space is tight may want to tiY reducing the number of 
records being used for paging. 

If the number of paging device records becomes too lew, users 
attempting to access a new page will receive the message "No free 
paging device records". 



Correction to PSD COPY Canmand 

On page A-9, the PSD COPY command used to relocate ^RI^DS II during a 
magtape boot is incorrectly shown with a relocation valtK of '57541. 
The correct value is '57477. The comnand given under point 17 should 
read: 

$C 10000 57477 130000 
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MaGSflV Error Messages 

Add the following to page K-3: 

MAGSAV has three new error messages: 

MftGSAV UNfiBLE TO OC»JTINUE 

MBGSAV cannot find a UFD in a pathname. MAGSAV prints the ERIMDS error 
message plus this message and exits. 

HJN CUT OF UKETS 

ALTER NUMBER OF UNITS 

treename 

TXPE 'S' TO CONTINUE 

MSGSAV ran out of units to open UEDs on. The file concerned will be 
lost. 

•TOO MANY LEVELS' treename 

MAGSAV can only save up to 18 levels on ERIIDS, 13 on HIIMDS II. If 
more than these levels are attempted, MAGSAV will print this message, 
ignore tiiat file, return to the previous level, save the files at that 
level and continue back up the tree in that manner. 

Note 

A ERIMDS systan configured for 16 file units/user can save only 
13 levels. 
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CXBCL REFEE?ENCE GUIDE - FDR3056 

Correction to UNOOMERESSED Opbion 

Replace the first paragr^h on page 7-4 with: 

1 The UNOOMIRESSED clause is optional. When used, it enables a READ 

base on record lengcn lirKwr?;?;, lauict uiica» ^..if^^ 

characters (I$SDCr7) . 

(The reference to subroutines H?WFIL and RDftSC is obsolete) . 



THE FORTRAN 77 REFERMCE GUIDE - IDR4029 

Performance Improvements 

The overall compilation rate for F77 source pcograns vdth a 
"reasonable" number of comments should exceed 1500 lines per ™te in 
most cases. We have observed compilation rates ^^^^f e^^?!. ^500 lin^ 
per minute on some real benchmarks. Programs that consist ^f^f 
Sta statatients will compile much slower thai 1500 LIM figure, 
particularly if large arr^s are being initialized. 

The most notable case of improved object code for E77 involves 
Se^s to aS^J where considerably shorter code is generated for 
references such as 

X(I+5,J-4) 

Z(I+4) 

Y(I,1) 

Major iniprovements were made in the code generated ff^maig string 
SratioS, but these changes will probably not be iiii»rtant for mose 
F77 programs. 

The single precision math routines (SQRT, SIN, COS, etc.) were 
rSriSln for greater accuracy. In most cases, the new versions are 
slightly faster than the old versions. 
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Clarification of STOP Statement 



On page 3-22, delete the sentence recommending CALL EXIT as a 
substitute for STOP. CALL EXIT is not equivalent to STOP because STOP 
closes all file units opened by the program, while CALL EXIT leaves 
such file units open. 



Clarification of Sequential and Direct File Access 

In Section 4, files created using the sequential access method are 

^'^^ ^ J^^' fl*? ^^^ created under tiie direct access method are 
termed DAM files. This terminology is incorrect. 

The terms "SAM" and "DAM" refer to the two basic file crganization 
mims uses to implonent fUes. These organizations are not specific 
to any one langiage. The terms "sequential access method" and "direct 
access method refer to the two types of file offered ty the FCmim 77 

if?w^TM?o^?-n *^ "*. ^?°^ ^^^ «^"1^ ^ implanented using 
either ERIMOS file organization. The implonentation used is 
transparent at the programming level, and is subject to change. ' 

For detailed information on IRIM3S SAM and DAM files, see The ERIfOS 
Subroutines Reference Guide - (PDR3621) . au.nji> 

Internal Files 

Replace the third paragraph on page 4-4 with the following: 

When an internal file is an array, each array elanent acts as a 
separate record. if the file is a variable, array elanent, or 
substring, the file consists of a single record. After each read or 
write of an internal file, the file pointer returns to the beginning of 
7?f ^^' .u'^ access records other than the first in an array internal 

•rilo_ ilea *-ha o1 o^^U / /\ ^jJx. j j—j -' ■"'"-'-'-*»"J. 



file, use the slash (/) edit descriptor. 



C^imization Options 



In addition to the options listed in Table 7-2, there are three levels 
of optimization: -om, -QPK, and -QPT3, v^ere the default is 

"°S!^L::°^ "^ °^*^ °P^^°" -OPTIMIZE is retained and is synonymous 
with -0Pr2. The chosen level is noted in the option header line ctf the 
compiler's listing output file. Optimization is turned off, as before, 
ty specifying -NOQPT. ' 

^le effect of specifying -0FT2 is elimination of the optimizer logic 
that moves invarient code out of loops. This is a costly process that 
^^ to consume up to 15 per cent of total compile Ume on 
programs with many nested DO loops. It is still available using -OPTS 
and IS useful in compiling fully debugged programs to be used in 
frequent production situations. The default optimization (-QPr2) 
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perfonns both code pattern replacanent and redundancy elimination. The 
lowest level (-QPTl) does only pattern replacement. 

Correction Ccaicerning Statement Functions 

Delete the last paragraph on page 8-4 and its header. In F77, 
statement functions and function subprograms execute with equal 
efficiency. 

FIN - F77 Interface Restriction 

To the list of restrictions at the top of page A-3, add: 

• An F77 progran unit cannot pass a subprogram as an argument to an 
FTN program unit, nor can an FTN unit pass a si±>program to an F77 
unit. 
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THE ERSCAL REFEtlENCE GUIDE - IDR4303 



New j^peirfix 



APBEINDIX D 
INTEREftCING PASCAL TO FLIG MD F77 



This appendix provides three examples for interfacing Pascal to 
incompatible data types of ELI and FCSHTRm. The first two examples 
deal with argument passing of character data types from Pascal to ELI 
and F77, The last example describes the correct procedire for testing 
FQEORfiN LOGICMi's from Pascal, (i.e. APELIB) . 



EXAMPLE ONE 



{ <char-star.pascal> Passing character { * ) and character* { * ) parameters 

to ELIG and F77 respectively from Pascal. 

This example program passes any length string from a Pascal program 
to either HilG or F77. Note, the strings being received in the PLIG 
arK3 F77 programs have star extents for their dimensions. PLIG and 
F77 pass these extents as hidden arguments at the end of the users' 
argument list. Pascal users must pass these extents as actual 
arguments since star extents are not supported in Primes' Pascal. 
The follcwlng program does just that. 

} 

program chrNcnVr; 
type 
longlnteger = 
-32769 .. 32769; 

strings = 
array[l ,. 5] of char; 

stringlO = 
array [1 .. 10] of char; 

var 

pl,p2 : strings; 
pR : StringlO; 

fl,f2 : strings; 
fR : StringlO; 

procedure PGooncat(var sl,s2,s3 : char; { First element of string } 
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U, 12,13 


: longlnteger 


); extern; 




procedure F7concat(var sl,s2,s3 


: char; 


U, 12,13 


: longlnteger 


); extern; 




begin 




pi ! 


!= '12345'; 




P2 ' 


;= '6789.'; 




f 1 ' 


!= pl; 




f 2 ' 


!= P2; 




fR 


!= pR? 
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{ Extents of the string } 



{ First element of string } 
{ Extents of the string } 



PGconcat(pl[l],p2[l], pR[l] , 5, 5, 10); 

F7concat(fl[l], f2[l], fR[l] , 5, 5, 10); 

if (fR = pR) and 

(fR= '123456789.') 
then 
writelnC PASS... strings (non-varying) in Pascal, ELIG, and F77') 
else 
writelnC FAIL... strings (non-varying) in Pascal, PLIG, and F77'); 



end. 



/* <PGooncat.pllg> PLIG procedure to concatenate 2 strings to form 
a third. Accepts as inpwt 2 character nonvarying strings 
a returns a nonvarying string as third argument */ 

PGooncat : procedure (si , s2 , s3) ; 

declare (si, s2, s3) character (*); 

s3 = sl||s2; /* concatenate strings and return */ 
end PGooncat; 



C <F7concat,f77> F77 procedure to concatenate 2 character* (*) strings 
C to form a third. Accepts as input 2 character* (*) strings and returns 
C a character* (*) string as the third argument. 

subroutine F7concat(sl,s2,s3) 
character* (*) sl,s2,s3 

s3 = sl//s2 /* concat the strings */ 

return 

end 
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/* <char-star.pllg> Using CHflRACTER( * ) parameters in pllg. */ 
/* The following is the equivalent HJ.G program to perform the same 
task as the Pascal program used before for passing star extent 
character strings. */ 

main: procedure options (main) ; 

declare ( fl , f2 , pi , p2 ) character ( 5) ; 
declare (fR, pR) character (10) ; 

/* Note; only 3 arguments are required in PILl. The HJ.G ccmpiler 
supplies the hidden arguments defining the dimensions of the 
character strings passed. 

V 

declare (F7concat,PGooncat) entry ( character (*) , 

character (*) , 
character (*) ) ejcternal; 

fl = '12345'; 
f2 = '6789.'; 
pl = fl; 
p2 = f2; 

call PGooncat(pl,p2, pR); 
call F7corKat(fl,f2, fR); 
if pR = fR 
then 
put skip list ( 'Pass. , . string (non-varying) PLIG calling' ) ; 
else 
put skip list ('Fail... string (non-varying) PILIG calling') ; 
end main; 



EXAMPLE OWO 



{ <readttY.pascal> Reads text from the user terminal using the external 

ERIMDS routine - cl$get 

This program provides an example on how define a suitable Pascal 
structure for implementing the character varying datatype found in HJ., 
Since standard Pascal prohibits reading string data from files 
without subscripts, this example will provide an alternate 
solution for reading strings from the user terminal, without 
e:q)licit subscripting. 

The simple dDject of the program is to read 3 strings from the terminal 

and display them in complete reverse order. 
} 

program readTTY; 
type 

Icaiglnteger = 
-32769 .. 32769; 
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charSOvarying = 
rec»rd 
1 : integer; 

s : arraY[l .. 80] of char; 
end; 

var 

cmdline : charSOvarying; 

table : array [1 .. 3] of charSOvarying; 

i,j : integer; 

status : integer; 

{ This procedure is documented in the HUH)S SUBRODTINES REFERENCE GUIDE - 
PDR3621, page 5-2. } 

procedure cl$get(var ondline : charSOvarying; { Comnand line input buffer } 

lenBytes: integer; { Length of cmdline in bytes} 

var status : integer) ; { Return error code status } 

extern; { Ejcternal ERI^DS procedure } 

begin 

{ Loop to input the text entered from the user terminal using the 
fRIMDS routine defined above (cl$get) , 

} 

for i := 1 to 3 do 

begin 

write(i:l.'> '); 

cl$get (cmdline, 80, status); 

if status <> 
then 
writeln('Bad status code returned, status =', status); 

table [i] := cmdline; { save the command line } 
end; 

{ Display the lines just typed in reverse order, } 
writeln; 

for i := 3 dovmto 1 do 
begin 

write (i:l,'< '); 

for j := table[i].l downto 1 do 
write (table [i].s[j]) ; 

writeln; 
end; 



EXAMPLE THREE 

{ <aEplib.pascal> Example of how to interface a Pascal program to the 
standard APPLIB routines. 

FORIRflN logical 's ARE incompatible with Pascal boolean data types. 
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Therefore, interfacing to the applications library from Pascal 
can be a problem. The following "progran" shows the easiest way to 
to determine True and False when calling FORIRflN subroutines with 
logical 's. 

Note: This program assumes that the type of logical returned is 
a L0GIC]AL*2, and only occupies 2-byt:es of memory. If the 
PQRIEfiN subroutine called was compiled with default options 
using F77r the type of result returned by the FOKIEfiN 
subroutine would have to be a Loig Integer. 

program main; 
const 



type 

longlnteger = 

-32769 .. 32769; 
strings = 
array [1 ,. 8] of char; 

stringie = 
array [1 .. 16] of char; 

var 
msg : stringl6; 
date: stringl6; 
time: strings ; 

procedure date$a(var s : stringl6) ; extern; 
procedure tdme$a{var s : stringS); extern; 

function ysno$a{var s : char; {Pass fcy ref , first loc of the msg } 

1 : integer; {Pass ty value, length of msg } 

k : integer {Pass by value, default k^s } 

) : integer; extern; {Returns fortran logical as integer } 

begin 

date $a (date) ; {Read today's date } 

time$a(time); {get the current time} 

writeln; 

writelnCToday^s date: ',date); 

writeln ('Time: •,time); 

writeln; 

msg := 'Yes | No '; 

if ord( True ) = ysno$a(msg[13 ,S, a$ndef) 
then 
writeln ('Ok!') 
else 
writeln ( 'Absolutely NOI ' ) ; 
end. 
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T?he PASCMj compiler supports the follcwing option: 

-UPCaSE 
-UTCRSE maps lowercase characters into uppercase characters in identifiers. 
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THE H/I SUBSET G REFERENCE GUIDE - IDR4031 

New Options 

Add the follcwing options to page 14-7: 

-ERRTTy - List errors on the terminal 
-NOERRTTZ - Do not list errors on the terminal 
-ERRLIST - Produce an errors-only listing file 
-PRN - Round the floating accumulator before storing a 
float bin (23) 

Maximum Sizes Add the following information to the MRXEMUM SIZES list 
on page 11-1 of The VL/1 Subset G Reference Guide ; 

• The maximum number of %INCLUEE nesting level positions is 32. 

• The maximum number of items in a structure is 1024. 

caiange in SKIP format 

A value of can now be given for n in the SKIP format. In the SKIP 
format discussion on page 9-16, the third paragr^ that begins "If n 
is omitted," shcxild now read: ~ 

"If n is omitted, a value of one is supplied. The value of n must 
not be negative. If is given the current line will be 
overwritten, " 
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EDITOR 

The FNZVME Canmand 

Insert the following information after the discussion on the WHERE 
cxjinmand in Section 3 of The New User's Guide to EDITOR and RUNOFF - 
(FDR3104) . 

The FNAME ooinraand prints exit the name of the file you are working on 
during an editing session. For example, if you are editing a file 
called junk , the FNAME command will print the filename junk wherever 
you issue the command in the file: 

Print 2 

The name of this file is called junk. 

.sk2 

fname 

JUNK 

If you're working on a r^w file and haven't yet ^aecified a filename, 
the" FNAME command will elicit this message: 

File name not specified 

MDIE NOSEMI and lyPDE SEMI 

The following information affects Section 9 of The New User's Guide to 
Editor and Runoff - (FDR3104) and Section 4 of The Prime User's Guide - 
(PDR4130). 

NOSffll mode eliminates the need to use the CHANGE command to insert 
sonicolons in a file, using either input mode or edit mode. 

in input mode, MDOE NOSmi causes the EDITOR to treat a semicolon as a 
regular print character instead of a line terminator. 

in edit wode WDDE NOSEMI causes the APPEND, INSERT, and RETYPE commands 
to treat semicolons as literals. For example: 

OK, ed sheep 

EDIT 

mode nosemi 

next 

BA, BA BLACK SHEEP 

append; HAVE YOU ANY WOCL 

BA, BA BLiCK SHEEP; HAVE YOU ANY WOOL 
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The aemicx>lon still terminates (or separates) EDITOR commands that do 
not insert new text into the file. For example: 

OK, ed sheep 

H)IT 

mode nosep ii 

t;n 

BA, BA BLKK SHEEP 

WCE SMI causes the EDITOR to recognize the sonioolon as the line 
terminator wten in input mode. The default semicolon mode is MOIi; 
SEMI. 



ASSIGN 

Add the following to page 2-6 of The Prime User's Guidp : 

Mounting Tapes: When you assign a tape drive, you m^ also specify a 
particular tape to be placed on the drive fcy using the -TPID control 
ar^ment. Sonetimes it is necessary to have one tape removed from the 
tape drive and another tape placed or mounted on the tape drive. This 
is done by using the -MODRT control ar^iment. To specify -MCUNT, the 
tape drive must alrea<^ be assigned. For example, suppose AELEy, user 
number six, assigns logical drive seven: 

OK, ASSIGN MTO -ALIAS MT? -800 BPI -TPID GRAMS 
OK, 

New, suppose AELEY reads or writes the tape with id GRADES, and then 
wants another tape mounted. AEIiEy types: 

OK, ASSIGN -ALIAS MT? -MXIOT -TPID EXAMS 
OK, 

The operator receives a message at the system terminal indicating that 
user AELEY wants tape EXAMS mounted. The cperator responds to ACLEY's 
request ty using the REPLY command. ADLEY thai receives a message 
indicating whether cm: not the mount (^ration was successful. The 
mount operation might be unsuccessful, for example, if the operator 
could not find the requested tape. 

LC«D ((30RRBCTK»?) 

Delete the phrase "(to which LOAD will add the SAVE suffix)" from page 
6-8 of The Prime U ser's Guide . 

LOAD appends the .SAVE suffix only to default filenames which it 
creates itself. It does not append the .SAVE suffix to user specified 
filenames. 
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Hffiwrayi logout {cx)rrbction) 

Delete the information on phantom logout notification and its 
associated subroutines, LO$CN and LO$R on page 9-11 of The Prime User's 
Guide and on pa^s 78-6 through 78-10 of FPU78 - Si±>routines. This 
functionality is not provided at Rev 18. 

CRMPC (CX)ReBCriON) 

Replace the , section on page 12-2 of The Prime User's Guide beginning 
"Source deck header control cards..." and erring "...ty the command 
START at tiie terminal." with the following: 

The C3»5PC command translates the card images into an ASai file. Cards 
are e^^cted on 029 representation. Ccaitrol cards m^ be inserted into 
the card deck to instruct the card reader as follows: 

Columns 1 and 2 of Instruction 

deck control card 

$6 Placed brfore a deck of cards in 026 

format. Instructs the card reader to 
interpret 026 cards as if they were in 
029 format. 

$9 Instructs the card reader to resume 

reading in 029 format. 

$E Placed last in the deck and signals the 

end of the deck. Control returns to 
ERIMDS and the file is closed. 

If the card deck is ejdiausted but contains no $E card at the end (or if 
the reader is halted ty the user) , control returns to ERIiyDS but the 
file is not closed. If more cards are to be read into the file, the 
reader should be reloaded; reading is resumed by the command STJSRT at 
the terminal. 
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SUBROJTINES 



Change the type declaraction of LOGICMi ai page 11-48 of Ihe FRItOS 
Subroutines Reference Guide (H)R3621) to read L0GICftL*2, 

This change makes A$KEyS, the $INSERT file used with APFLIB and VAPHB 
to define parameter keys, compatible with F77. 

Formerly, A$KEys declared its logical variables as LOGICAL. This 
created an incompatibility with F77 because LOGICAL defaults to 
L0GICAL*4 in F77, vMle APELIB and VAPHB ej^ject L0GICAL*2 arguments. 

Tte logical variables in A$KEyS are now e:^licitly declared as 
L0GICAL*2, eliminating the incompatibility with F77. 



Replace T$AMLC description on page 20-16: 
AS^NCHRCNOUS CONTRCLLERS 



The following describes the raw data mover for assigned MLC lines. 
Refer to the System Administrator's Guide for the AMLC canmand, and how 
to assign AMLC lines. 



T$AMLC 

T$AMLC is a direct entrance call. It performs raw data movement, 
provides status information about assigned amlc lines, and transfers 
characters to and from the caller's buffer to a desired assigned line's 
buffer. The caller must cwn the desired line, i.e., the corresponding 
LBT entry must contain the caller's user number. 

CALL T$AMLC (line, user_buf_addr , char_count, key, 
stat_vec,char_pDS_arg, erroode) 



lirte Desired amlc line number. 

user_buf_addr Address (pointer) to the caller's buffer. 

char_count Desired number of characters to move. No maximum limit 
is enforced. 



key 



1 input char_count characters. 

2 input char_count characters or until .NL. 
stat_vec{l) = actual number of characters read. 



REV. 4 - 



MRUS UTILITIES 



3 output char_count characters. 

Maximum = char_count. This key assures the caller 
that char_oount characters will be output. For 
example, an error is not returned if the line's input 
or output buffer is smaller than char_count. T$AMLC 
will output blocks of data from the caller's buffer 
into the available room in the line's output buffer 
until char_count is ejdiausted. A one second wait is 
issued between output chunks to allow time for the 
line's output buffer to clear. In most cases, the 
entire diar_cx)unt should be output at once. 

4 stat_vec(l) = number of characters in input buffer. 
stat_vec(2) = state of carrier. 

5 return status of output buffer. 

stat_vec(l) = 1 if roan for char_count in output 
buffer. 

e<4-a'(- TTn^/1\ — n i^ ^r^t- »n^.i»U _^.~_ £._ _!.__ J- 

*='-<-' >-__».^»'V-«-; — W XJ. IIK/U CllVJU^il X.t^«^U J.UL ^11CU._VUU11U. 

stat_vec(2) = state of carrier. 

6 input all available characters in the input buffer. 
Maximum = char_count. This key will place all the 
available characters in the line's input buffer into 
the caller's buffer. 

stat_vec(l) = number of characters actually input. 

7 return aAJitional output buffer status (refer to key 
5). 

stat_vec(l) = amount of character space remaining in 
the 

output buffer. 

8 flush input buffer. 

9 flush output buffer. 

10 flush both output and input buffers. 

11 output diaracters to available room in output. 

This key will output as many characters as possible 
into the line's output buffer. Await will not be 
done to esdiaust char_count, 

stat_vec(l) = number of chars that were not 
successfully output, i.e. stat_vec(l) = 0: means all 
characters were output. 

stat_vec IVo word status vector used by certain keys. 

char_pos_arg The caller may wish to indicate a starting position 
within the buffer addressed by user_buf_addr. 
Charjpos_arg applies for both input and output keys. 
This is an optional argument. If emitted, the default is 
to start with the first character. Note: if 
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char_pos_arg is used, the first charac±er position should 
be indicated by one (there is no charac±er at position 
zero) . Also, char_pos_arg is NOT updated within T$AMLC. 

erroode Optional argument to return error status. If erroode is 

present, error messages will not be printed at the 
caller's physical terminal. 



SOURCE LEVEL EEBOGGHR REFERENCE MfiNUAL - IDR4033 

PASCMi Additions 

Oiange page 1-3 language support description to include IftSCMi. 

Add to page 3-7: 

PASCAL: A PASCAL program block is a main program, procedure, or 
function, and is identified by the name given in the 
PROGRAM, EROCEDURE, or FUNCTION Statement. Nested 
procedures are qualified as th^ are in VL/l, 

Change page 3-11 statonent label description to include PASCAL - 
statement-label may be a PASCAL statement number preceded by a dollar 
sign, 

Chan^ page 5-3 : command description to include PASCAL as a valid 
language-name value. 

Replace builtin function list chi page 4-13 by the following listing 
which includes PASCAL functions. 
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ms 


COMPLEX 


HBCUND 


NMT 


flCOS 


OONJG 


HIGH 


NOT 


ADD 


COPY 


lABS 


NULL 


ADDR 


COS 


IDIM 


ODD 


ADDREL 


GOSD 


IDINT 


OFt^ET 


AFTER 


COSH 


IDNINT 


ONCODE 


AIMAG 


CSIN 


IFIX 


OR 


AINT 


CSQRIl' 


IMAG 


QRD 


ALOG 


mBS 


INIEX 


POMl'ER 


ALOdO 


DATM 


MP 


PRED 


AHAXO 


DATM2 


MEL 


ETR 


AMAXL 


DATE 


MES 


RANK 


AMINO 


DRT.E 


IRND 


REAL 


AMINl 


DCOS 


ISIGN 


REVERSE 


AMDD 


DDIM 


LBOUND 


RND 


AND 


DEC 


LEN 


RS 


mmr 


lECAT 


TiRNGTH 


m: 


ASDJ 


DECIMAL 


LGE 


SEARCH 


ATM 


mw 


LGT 


SHFT 


ATAN2 


DIM 


T.T,R 


SIGN 


ATAND 


DIMENSION 


LLT 


SIN 


ATANH 


DINT 


LOC 


SIND 


BEFORE 


DIVIDE 


LOG 


SINH 


BIN 


UUDG 


LOGIO 


SNGL 


BINARY 


ELOGIO 


L0G2 


SQRi" 


BIT 


EMAXl 


LOW 


SUBb'i'K 


BOCL 


EMINl 


IS 


SDB1RACT 


BYTE 


EMOD 


LT 


SUOC 


CABS 


DNINT 


MAX 


TAN 


CCDS 


DERCD 


MAXO 


TMD 


CEXP 


DSIGN 


MAXl 


TANK 


CHR 


DSIN 


MIN 


TIME 


CLOG 


DSQRl' 


MMO 


TRANaiATE 


CMELX 


EXP 


MINI 


VERIFY 


CMPX 


FIXED 


MOD 


XDR 


aXLATE 


FLOAT 


MULTIPLY 





Change page 5-17 LANGUAGE cx)inniand description to include PASCAL . 



UIWJCTCH Ccmmand Changes 

On page 5-38 add the option -ALL to the UNWATCH coiratand list. If 
UNWAICH -ALL is specified, all variables are removed from the watch 
list. 
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VTRflCE Command Changes 



On page 5-39 replace the cxDinmand line and first paragraph of the VlRflCE 
cxanmand with the following: 

The VORACE ooinmand allows the user to enable full or entry/exit value 
tracing, or to disable value tracing at any tLme, vdiile retaining the 
variables in the watch list. 

The format of the command (abbreviated VT) is: 
VTOflCE { FOLL I QraRY_EXIT | OFF } 

The OFF ar^iment disables value tracing without disturbing the contents 
of the watch list. The FULL and ENTRY_EXIT arguments control the 
frequerKY of comparisons of saved values to aarrent values. If "full" 
value tracing is enabled, comparisons occur following execution of each 
statement. If "entry_exit" tracing is enabled, values are compared 
only at entry to and exit from each routine in debug mode. 

HELP Command Changes 

On page 68-3 of PIU68 - EBG - replace the description of HELP with the 
following: 

The HELP command may be used to find the name of the most recent and 
up-to-date EBG documentation. It may also be used to display a list of 
all debugger commands, the syntax of any EBG command, a list of all 
syntax symbols used in EBG command syntax descriptions, or the 
definition of a command syntax symbol. 

The format of the HELP command is: 

HELP [-LIST I -SYM_LIST I command-name | syntax-symbol] 

Where: 

command-name is the name or atforeviation of a EBG command. 

syntax-syntool is a symbol eiKilosed in angle brackets used in a 
command syntax description, for example, "<breakpoint-identifier>". 

If the HELP command is issued with no arguments, the syntax of the HELP 
command and the name of the most recent IBG documentation are printed. 
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> HELP 

For help, refer to IDR4033 Source Level Debugger Reference Manual. 



HELP -LIST 
HELP -SYM_LIST 
HELP <coinniand-name> 
HELP <syntax-syiitool> 



prints a list of all EBG cOTonands 
prints a list of all syntax symbols 
prints the syntax of <co[nmand-name> 
prints the definition of <syntax syirbol> 



If -LIST is specified, a list of EBG ooinnands is printed. Comraand 
al±)reviations are indicated by capital letters. 



> HELP -LIST 
! 
ActionList 


1c 


• 


MGumentS 


• 

BRpoKpoint 


CALL 


CLeaR 


CLeaRAll 


CmdLine 


Ccxitinue 


ENVironrnent 


EnvLlst 


Wi'raoe 


GOTO 


HEr.P 


IF 


IN 


INFO 


UMSuage 


LET 


LIST 


LiSTAll 


Loads tate 


MACro 


MacroList 


MAIN 


OJT 


PAuse 


mode 


PSMbol 


Quit 


ReSTart 


ReSDtmit 


SaveState 


SEGmentS 


SouRCe 


STATUS 


Step 


StepIn 


STrace 


S!Mbol 


TraceBack 


OSAcepoint 


TYPK 


UriWatch 


UWIND 


vPSD 


VTrace 


WAI-ch 


WatchList 


WHere 







If the HELP coinmand is followed by -SYM_LIST, a list of all EBG 
syi±)ols used in IBG command syntax descriptions is printed. 



syntax 



> HELP -SYM_LIST 
ACTION-LIST 
ALTERNATE-EMTRY-ID 
BOUND-PAIR 
CHARACTER-VALUE 
EXPRESSION 
LANGUiV3E-NAME 
MACRO-NAME 
PRIMOS-COMMAND-LINE 
HIOGRAW-BLOCK-NAME 
SOURCE-LINE 
STATEMENT-OFFSET 
STOTAX-SYMBCL 
VARIABLE 
WORD-NUMBER 



ACTIVATION-NUtBER 

ARGUMENT 

BREAKPOINT- IDENTIFIER 

OCMMAND-LIST 

FILE-NAME 

LINE-OFFSET 

NEW-MACRO-NAME 

FRINT-MDDE 

SBG^ENT-NUMBER 

STATEMENT- IDENTIFIER 

SIEP-GCMMAND 

UPEER-BCUND 

VARIABLE-LIST 



ALTERNATE-ENTRY-NAME 

ARGUMENT-LIST 

BREAKPOINT-TYPE 

OBMAND-NAME 

INSERT-LINE 

LOWER-BOUND 

CLD-MACRO-NAME 

PROCEDURE-NAME 

Sa]RCE-CC»lMAND 

STATEMENT-LABEL 

SYMBOi-NAME 

VALUE 

VARIABLE-NAME 
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If HELP is follcwed hy a <coinmand-name>, the syntax of that cxxranand is 
dispiLcyed. 

> HELP INFO 

INFO {<prograDn-block-name> \ | 
<alternate-entry-id> | 
<stateinent-identif ier > } 

If a <syntax-syinbol> follows HELP, the definition of tiiat syntool is 
printed. 

> HELP <STJCTEMENT^IDSMTIFIER> 
<STATEMENT-IDENTIFIER> : 
<source-line> i 

<source-line>-Kstatenient-offset> | 
<source-line> (<inaert-line>) I 
<souroe-line> {<insert-line!>+<statament-offset>) I 
<statement-label> I 
<stat€ment-label>-Kline-offset> | 
<statenient-label>-Klire-offaet>-Kstatement-offset> 



MflCRO Command Changes 

On page 68-5 of PrU68 - DBG - replace the description of MACRO with 
the following: 

Using the MACRO ooinmand, the user can define a macro name which may 
be used in place of one or more debugger commands. 

The format of the command (abbreviated MAC) is: 

MACR O macro-name {command-list i -DELETE i -EDIT} j 
-a!fiNGE_MME old-macro-name new-itacro-name | 
-CN I -OFF 



Where: 

macro-name and new-roacro-name are user-supplied names, 

command-list is one or more debugger commands enclosed in square 
brackets ("[]"). 

old-macro-name is the name of an existing user macro, 

A macro is defined with the MACRO command by entering a itacro-name 
followed by a command-list . The macro is then entered into a 
debugger table known as the "macro list". Thereafter, vAienever 
macro-name is entered at EBG command level, the debugger commands in 
COTimand-lIst will be executed, with sujplied parameters, if any. 

A macro-name is removed from the macro list by supplying the argument 
REV. 4-10 
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-DELETE. 

The -EDIT argument indicates that the cxanmand-list associated with 
this macro-name is to be edited using the EBG command line edit 
facility. 

The -aKNGE_NME argument may be used to change the name of a user 
macro f ran old-macro-name to new-macro-name . 

The MftCHO -OFF command inhibits eJ5)ansion of user macros without 
disturbing the macro list. 

The MACRO -CN command reenables ej^ansion of user macros. 



SfikV^TJfflE Comnand Changes 

On Twae 68—5 of Fru68 — EBG — re'^lace the description of SAVESTiffiE 
with the following: 

The SAVESTATE command may be used to save certain debugging 
information for restoration at a subsequent invocation of EBG, 

The format of the SAVESTATE command (al±)reviated SS) is: 

SAVESTATE file-name [-MACROS] [-^S^OINTS] [-^ISACEIOINTS] 

Where: 

file-name is a tree name describing a file. 



Wnsn this command is issued with no control armaments, the following 
are saved: all tracepoints and brealqx5ints with associated action 
lists and attributes, and all user-defined macros. EBG commands to 
restore this information are written to file-name in user-readable 
form. 

If ary of the arguments -MRCROS, -BREAKPOINTS, or -TRACEPOINTS are 
specified, then only those items requested will be saved. 
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GENERAL DATA BASE INFORMATION 



Gemral Note to EBMS Users 

The w^ in which EBMS alters set currencies for optional member record 
occurrences now conforms with CDDASIL specification. If a record is 
defined as optional manual, mandatory manual, or optional automatic, 
m.6 does not mrticipate in any set occurrence of the set, set currency 
will not be affected ty that record. Previously, when a record became 
current, all set currencies that the record occurrence could belpng to 
were updated. This was done v^ether or not the record actually 
participated as a member of the set. 

With revision 17 .6 the only currencies updated are those in which the 
record occurrence actually participates. 

Application programs conforming to present documentation are not 
affected. However, if a record does not currently participate as a 
manber in a set (set X) , a FIND OWNER in X of current of set X, will 
result in a "stale" owner record — the owner of the roost recently 
found raonber record that does participate as a member in set X. 



Converting Pre-Rev. 18 Data Bases 

Since the size of the before- image header has been increased, pre-Rev. 
18 schonas will NOT work correctly unless the following actions are 
taken: 

1. BEFORE installing Rev. 18, run before-iitiage recovery on all 
schanas and do SAVEs for each schema. 

2. Install Rev. 18 EBMS. 

3. In EBOTL, make the schema the current one (e.g., SC MYSCHEMA) 
and then type the EBUIL REV18 comnand, 

4. Rev. 18 will then do this one-time per schema conversion. 

Any SAVES of pre-18 schonas will not work correctly on a Rev. 18 
system. Consequently, if you restore a pre-Rev. 18 save, invoke EBUTL 
and type the REV18 command to convert the restored data base. It is 
recommended that you do a new save of the schema so that you have a 
replaoanent for the pre-18 schana. 
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If you are not sure if a schana has been converted to Rev. 18 format, 
invoke EBOTL, DUMP BEEDRE and ejsamine GEJBIT. If GENBIT is 8 words 
long, the schema has been converted; if it is 4 words long, it has 
not. 

If you attempt to run a pre-18 schema, you will get the message: 

THIS SCHEMA NEEDS EBUTL REV18 (CONVERSION 
CX5NTACT EBA FOR INSTRUCTIONS 

WARNING 

There is no mechanism for preventing inappropriate conversion 
(i.e., conversion of schemas either created with an 18 or 
higher version of EBMS or schemas that have alrea(^ been 
converted) . The EBA must exercise caution in this area. 



THE EBMS AEMINIOTRATOR' S GUIDE - H3R3276 

EBACP RBCWER SCHEMA Cctmnand 

If you type the EBACP RBCCVER SCHEMA command and run-units are 
accessing the data base, EBi^CP asks the question: 

DO YOU WISH TO ABCKT THE RUN-UNITS? 

If you answer YES, EBACP waits for you to abort all run-units accessing 
the data base. This is done ty logging these run-units out' from 
another terminal. After you log these run-units cwt, run CLUP so that 
the data base is in a correct state. Wnen you run CLUP, do not forget 
to use the: 

CLUP -U user-number 

form of the CLUP command. 

Note 

Do not CLUP a run-unit while it is running or a loss of data 
integrity will result. 

After EBACP determines that no one is accessing the data base, it 
perf canms the RECOVER operation. 

If you type NO, IBPCV asks: 

DO YOU WISH TO WAIT FOR THE RUN-UNITS TO FINISH? 

If you answer YES, EBACP will wait until it determines that no one is 
accessing the data base. It then performs the recovery operation. 
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If you again type NO, EBACP returns to its ooratnand level. 

SCHED 

When adding new files (e.g., areas, sets, etc) or modifying existing 
files, SCHED now creates DAM rather than SAM files. The follcwing 
procedure identifies and corrects existing data bases: 

1. Attach to all H»MS UFD's that contain production data bases, 

2. Use the file utility (FUTIL) to find if ar^ EBMS files are SAM 
files by first using FRCM SESmnn, vdiere nnnn is the SOBEMA 
number, zero filled. Then use L T, 

3. If there are ar^ SAM data base files: 

- Use IBPCP to SAVE the data base. 

- Dae mPCP to RESTORE the data base. 

All segment directory entries for the data base will now be DAM files. 

PrU73 - REV 18 EBMS 



EBUTL 

IWo commands, VERIFY and EBK, have been added. 

VERIFY ; For each b-tree in the current set, VERIFY establishes that 
every leaf node data base key is in the data base. The format of this 
command is: 

VERIFY [ integer ] 

If the optional integer argument is used, a checkpoint message will be 
displayed after the specified number of owner directories (i.e., set 
occurrences) have been processed. This numerical argument is a decimal 
number. 

The messages that can be printed are: 

1 COULD NOT POSITION TO ROOT OF B-IREE 

2 COULD NOT K)SITIC»« TO LEET-MDSP LEAF NCBE 

3 INFINITE LOOP IN LEAF WDE 'RICffiT' POINTERS 

4 GOULD NOT POSITION TO OHE NEXT (RIGHT) LEAF NQHl 
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6 EBK NOT m DATABASE 

7 EBK MARKED AS lELETED IN EftTABASE 

This cxramand also serves as a compliment to the new EMLCP cx>mraand which 
is described below. 



EBK: The format of this EBUIL command is: 

{ nl n2 n3 } 

EBK { } 

{ dbk } 

If you speify a data base key (dbk) in its logical format (vAiich is 
area-id, reoord-id, occurrence-number) , EBUTL displays the internal 48 
bit representation of the dbk as three decimal numbers. If you type 
the internal representation of the dbk (the three decimal number 
option) , EBUTIL displays the dbk in its logical (unpacked) format. 
This comand is used to determine the logical format of a dbk given the 
packed format displayed in EMLCP traces (e.g. , FTRACE) . 



EBMS FCKIEAN REFERENCE GUIDE - PDR3045 AND EBMS OCBCL REFERENCE GUIDE - 
IDR3046 



DMLCP 

The command line option -VERIFY has been added to EMLCP. This option 
lets an application program check record integrity in data base areas 
as well as check the consistency of CALC and set files. 

When using this option, the application program should contain a series 
of FIND (or FETCH) NEXT RECORD OF AREA Statements to check each key of 
interest, DMLCP locates the record using all keys (i.e., CRLC, sort, 
and search keys) defined for the record type and verifies that the 
record is contained in the non-sorted set occurrences for whidi it is 
currently a member. In addition, for each set occurrence that the 
record owns, EMLCP checks that the record's dbk is contained in the set 
file. 

The one inconsistency that EMLCP -VERIFY does not detect is the case in 
which a dbk is contained in a set list, but it is either not contained 
in the area file specified by tiie dbk or is marked as deleted in the 
area file. For this case, use when the EBOTL VERIFY command to detect 
inconsistencies of this type. (The EMLCP and EBU^ verifies are 
complimentary and do not overlap in functionality.) 
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When an inconsistency is ^tected, EMLCP writes a binary description of 
the error to a file opened on unit 45, Coisequently, a file must be 
opened on this unit number before the run-unit is invoked. For 
example: 

OPEN BOG, FILE 45 3 
SBG tHROGRAM -VERIFY 
CLOSE 45 

The program EBMSLB>VFYPRT. SAVE displays the contents of BUG, FILE in a 
formatted fashion, VFYERT will print a menu of options that can be 
used to display or analyze the bug file. For example, VFYERT can be 
used to print the definition of a particular bug number discovered via 
the -VERIFY, 



Creation of a EML j^lication Program 

Once a schema has been written and compiled and a subschema has been 
written and compiled, and the data base files have been allocated with 
EBICP, the user can write application programs for the data base in 
either GCBCL or FORTRAN, The sequence used to transform the' source 
code into executable code is as follows: 

1, Preprocess the source code with the host language preprocessor 
(CEML CR FDML) , 

2, Compile the output of the preprocessor (D_xxxxx) with the host 
language compiler (COBCL or FTO) . 

3, Link the binary output of the compiler to the EML command 
processor with the segmented loader SEG, 

Sample jct» streams to do these operations with either a ODBCL or PIN 
program may be found in UFD EBKBLB called C_CEML, CjCLOAD, C_FDML, and 
C_JLOAD, These template jobs are used in conjunction with EXEC. 



EML ERROR MESSAGE CLARIFICATIONS 

The following two minor exception codes have been added. 

39 Implicit access of a set not included in the subschema 

50 Retrieving next of set for set wherein current member removed 



- 5 July 1981 



SECTION 5 



MRUS 



DML SYMPAX 

In some cases, there has been scsne ambiguity concerning CXBOj and 
FCKIRAN oyiL syntax. The following pages describe all syntax. 

■The EML command descriptions use the following conventions: 



UPPERCASE Represent keywords that you must type as shown. 

UPPERCASE R^resent words that increase readability. You may 
include or omit these words at your discretion. 

lowercase Represent variables for which you must supply a value. 

{ } Enclose a group of options from which you must choose 
only one. 

[ ] Enclose optional choices; you can include the item or 
items in brackets, or you can omit it, as you choose. 

1 1 Enclose a group of options from which you can choose 
as many as you like; however, you must choose at 
least one. In all cases, v*ien you select more than 
one, options may be separated by commas if you so 
choose. 



-list 



Indicates that repetition is allowed. The portion of 
the format that can be repeated is delimited by the [ 
or { that logically matches the ] or } to the 
immediate left of the ... . 



Means you can repeat the last entity, 
the generic term "item-list" means: 



For example. 



item-1 [,item-2] 



"-list" is only used with lowercase variables (that 
is, ones for which you supply a value) . In all cases, 
a list could consist of only one entity. 

In many cases, the singulars and plurals of keywords are parsed 
identically; that is, if you see a plural, you can type the singular 
or vice versa. In particular, AREA and AREAS, RECORD and RECORDS, SET 
and sms, and ERRCR and ERRCKS have identical meaning. In most cases, 
only one form is indicated. 
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CXBCL Syntax 

fiBCKP TRANSACTION 

ABCJgr TRANSACTION identifier 

CLEAR ERROR 

CLEAR ERRdi . 



CLEAR SUPPRESS 



CLEAR 



aJETRESS 



ALL 



AREA 

SETS set-list 



CLOSE AREAS 



CLOSE 



ALL flREA[S] 
AREAS area-list 



DELETE 



DELETE 



MANDATORY 
SELECTIVE 
ALL 



END TOANSACTION 

EMD TRANSACTION identifier . 

EXIT EBMS 



EXIT 



ABORT 



EBMS 
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FIND/fETCH 














Format 1 






[fetch 






FIND 

V ) 


\ USING db-key . 


Format 2 




1 FE'TCH 
[FIND 


1 


• 


OWNER 
MEMBER 


• IN set-1 OF 


CURRENT OF 


[ RECORD record 
SET set-2 
AREA area 












-' 


. 


RUN-UNIT 



Format 3 



( FETCH 
FIND 



NEXT 
PRIOR 
FIRST 
LAST 



integer 
identifier , 



, RECORD [ record ] OF . 



SET set 
AREA area 



Format 4 



FETCH" 



FIND 



[ NEXT DUPLICATE WIOHIN 1 RECORD record . 



Format 5 



(fetch 



FIND 



record VIA [ CURRENT OF ] SET set [ USING item-list ] 



Format 6 



FETCH 



FIND 



NEXT DUPLICATE WITHIN SET set USING item-list . 
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GET 



GE?r [ item-list ] . 



IF 
Format 1 



IF set SET [ NOT ] EMPTY . 



cobol-procedure-1 
NEXT 



[ [;] ELSE oobol-procedure-2 ] . 



Format 2 



IF RECORD [ NOT- ] 



MEMBER 



a-JNER 



OF 



set SET 
ANY SET 



[ [;] ELSE cobol-proce(3ure-2 ] . 



cobol-procedure-1 j 
NEXT j 



INSERT 



(SEIS set-list 
INSERT INTO I 

[at.t. SET[S] 


■ 


INVOKE DBMS 


INVOKE EBMS . 


MODIFY 


MODIFY [ item-list ] . 


MOVE 


Format 1 


MOVE CURRENCY STATUS FOR 


r RUN-UNIT 
RECORD record 
AEIEA area 
SET set 




5 


- 9 



TO identifier . 
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Format 2 



MOVE I 



RECDRD-NAME 



i®EA-NAME 



'RUN-UNIT 

RECORD record 
FO^ I fiREA area 

SET set 
, identif ier-1 



TO identif ier-2 



CN ERRm 
Format 1 



[ ; ] Ojl Mi ERRORS GO TO c»bol-procedure . 



Format 2 



[;] {ON ERRCR integer-list GO TO cobol-procedure-1 } ., 
[ W OTHER ERRORS GO TO cobol-procedure-2 ] . 



OPEN iSREAS 
Format 1 



OPEN KL MS?S 

USAGE [-]M3DE IS 



EXCLUSIVE 
PROTECTED 



RETRIEVAL 



UEDATE 



Format 2 



OPEN AREAS area-list-1 



USAGE [-]MDDE IS 



EXCLUSIVE 
PROOECrED 



REORIEVALl 



UHDATE 



i 



; AREAS area-list-2 



USAGE [-] MODE IS 



EXCLUSIVE 
PROTECTED 



RETRIEVAL 



UPDATE 
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IKCVi^Cy KEY 
Format 1 

PRIVACY KEY FCR 



E}CLUSIVE 



PRCflECTED 



RETRIEVAL] 
UH3ATE 



AREZ^ area-list 



OF • 



ALL AREAS 



IS 



(identifer 
literal 



Format 2 



PRIVACY KEY FCR 



REST 
grOJRE 

lyPDIFY 

INSERT 

REMOVE 

DELETE MKNE ATCTIY 

DELETE SELECTIVE 

DELETE ALL 

FIND 



RECORDS record-list' 



OF i 



ALL RECORDS 



IS 



identifer 
literal 



Format 3 



PRIVACY KEY FCB 



REST 
grORE 
GET 
MODIFY 



jlli 



OF DATA-ITEMS item-list IS 



literal 
icfentifier 
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PRIViiCy KEY FOR 




SETS set-list 1 



ALL SETS 



IS i 



' identif er ' 
literal 



RHyCfVE 

REMOVE FRCM i 



SETS set-list' 
ALL SETS 



START TEANSACTION 

START T3?ANSfiCTI0N identifier 



, Ultft TB 
, REIRIEVAL 



STORE RECORD 

STORE record . 

SUBSCHEMA 

SUBSCHEMA subschema OF SCHEMA schema . 



SUPPRESS 



SUPPRESS 



ALL 



RECORD 

AREAS 

SETS set-list 
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FCRIRfiN DHL Syntax 

ABCKT 'mfiNSftCTION 

ABCECT IRMSJO^ION identifier 

CLEAR ERROR 

CLEAR ERROR . 



CLEAR SUPPRESS 



OjEAR 



bUi'JrKriiS 



ALL 



AREAS 



SETS set-list 



iJ 



CLOSE AREAS 



CLOSE 



ALL AREA[S] 
AREAS area-list 



EBiyS SUBPROGRAM 

EBMS SUBPROGRAM . 



DELETE 



DELETE 



MANDATORY 
SELECTIVE 
ALL 



END TRANSACTION 

END TRANSACTION identifier . 
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EXIT EBMS 

fEXIT 1 



ABCRT 



\ EBMS . 



FIND/fETCH 
Format 1 

FETCH 
FIND 



USING db-key . 



Foannat 2 



( FETCH ] 
I FIND ) 



OWNER 



MEMBER 



• IN set-1 OF 



CURRENT OF 



/ RECORD record 1 
SET set-2 
AREA area 
RUN-UNIT 



Format 3 



I FETCH ] 
I FIND j 



NEXT \ 

PRIOR I 

FIRST I 

LAST / 

integer I 
identifier / 



RECORD [ record ] OF . 



SET set 
AREA area 



Format 4 



FETCH 



FIND 



[ NEXT DOHilCATE WEffilN ] RECORD record . 



Format 5 



FETCH 



FIND 



record VIA [ CURRENT OF ] SET set [ USING ' item-list ] . 
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Format 6 



FETCH 



FIND 



NEXT DUPLICATE WITHIN SET set USING item-list 



GET 



GET [ item-list ] . 



IF 
Format 1 



IF set SET [ 



f fortran-label-1 

NOT ] EMPTY { 

I NEXT 

[ [ ; ] ELSE f ortran-label-2 ] . 



Format 2 



MEMBER 



IF RECORD [ NOT ] 



OWNER 



V OF 



set SET 
ANY SET 



[ [;] ELSE f ortran-label-2 ] . 



! fortran-label-1 
NEXT 



INSERT 

INSERT INTO 



f SETS set-list' 
ALL SET[S] 



INVOKE EBMS 

INVOKE EBMS . 

MODIFY 

MODIFY [ item-list ] 
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WOVE 






Format 1 






MOVE CURRENCY STimJS 


FOR 


/RUN-UNIT 
RECORD record 






AREA area 
SET set 


Format 2 






MOVE 


RE)CORD-NAME^ 
AREA-NAME 


FOR ■ 


RUN-UNIT 
RECORD record 
AREA area 
SET set 



TO identifier . 



, identif ier-1 



TO identif ier-2 



ON ERRC8R 
Format 1 



[;] CN Mi ERRCRS GO TO oobol-procedure . 



Fomat 2 



[;] { m ERROR integer-list GO TO cobol-procedure-1 } .. 
[ a^ OTHER ERRORS GO TO oobol-procedure-2 ] . 



OPEN AREAS 
Format 1 



OPEN ALL AREAS 



USAGE [-]]yPEE IS 



EXCLUSIVE 
EROTBCTED 



I RETRIEVAL 



I 



UH3ATE 
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Format 2 



OPEN AEIEAS area-list-1 



USAGE [-]PDDE IS 



E)CLUSIVE 
PROTECTED 



RETRIEVAL ] 
UHJATE 1 



'; AREAS area-list-2 

USAGE [-]M3DE IS 



EXCLUSIVE 
EROIECrED 



RETRIEVAL 
UPDATE 



PRIViCY KEY 
Fornvat 1 



PRIVACY KEY FCR 



Format 2 



PRIVACY KEY PCR 



Fejclusive 




RE-iRIEVAL 


\ 




PROTECTED 




UPDATE J 






[are 


^ area-listi 


IS 


[identifer 


OF . 


ALL AREAS 


[literal 


n 


/ REST 


DORE II 


> 




S 




GET 






MDDIFY 






INSERT 






\ REMOVE 


> 




DELETE MANDATORY 






DELKi'E SELhXrriVE 






DELETE ALL 






F 
\ 


IND 1 

[records record-li 


stf 




identifer 


OF ■ 


ATT, 


RBCO 


RD£ 






IS 


literal 
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Fonnat 3 



FBJMPC^ KEY FOR 



REST 



STORE 

GET 

MDDIEY 



_j 



OF DATA-ITEMS item-list IS ■ 



literal 
identifier 



Fonnat 4 



PRIVJCy KEY FW. 



REST 



INSERT 

REaypvE 

FIND 



OF 



SETS set-list' 
ALL SETS 



IS 



iidentiferl 
literal 



REMOVE 



REMOVE FRCM 



SETS set-list 



ALL SETS 



START TRANSACTION 

START TRANSACTION identifier 



, UIPA TE 
, RETRIEVAL 



STORE RECORD 

STORE re<X)rd . 

SUBSCHEMA 

SUBSCHEMA subschema OF SCHEMA schema . 
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SUPPRESS 



ALL 

SUITRESS I T Trbcprd 

AREAS 



}\ 



SETS set-list 
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THE mnfiS USER' S GUIDE - IDR4558 

The follcwing is a cxanpilation of error corrections and addenda. The 
changes are listed on a section by section basis. 

Section 2 Changes 

On page 2-3, the first sentence should read: 

• Secondary key types and siz^ — these are optional and should 
be used v*ien you want more than one seardh key for the f He, 
Secondary search keys do not have to be part of the data record 
except in OOBCL, 

Page 2-10 states that a read-write lock setting for n readers and n 
writers is "equivalent to the IRIICS FWLOCK setting of 3". This is 
incorrect. Instead, v^t was meant was that you would use the FUTIL 
"3" setting to set the file read-write lock to n readers and n writers. 

On page 2-11, the word "protected" should read "projected." 

Section 3 Changes 

There are several new messages output hy KBUILD during the process of 
building a file. Most of them should not concern the user as they are 
sirrply Informative and do not ira3icate difficulties. The diagnostic 
messages make itKMre sense if you understand how KBUILD goes about 
tuilding a MIDftS file. Briefly, KBUILD builds a MIDAS file in one or 
more stages, called "passes. " On each pass, one or more index subfiles 
are built or are deferred for building during a subsequent pass. The 
KBUILD message: 

FIRST BUILD/DEFER PASS OCMUOTl 

simply indicates that KBUILD has finished buHding the data subfile, 
(if the primary index needs to be built) and has built one or more 
indexes while possibly deferring the building of others. KBUILD defers 
the building of an index only if the index to be built is empty and the 
user-provided input is unsorted. During the first pass KBUILD puts the 
unsorted input entries for each such index into a temporary "defer" 
file. After tiie first pass is oon^lete, KBUILD sorts the individual 
defer files and builds the index subfiles from the now sorted data. 

Each time an index is sorted, KBUILD prints out a message indicating 
which index it is going to sort. After the sort is complete, the 
message: 
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SOFT CCMEIiETE 

is printed. Similarly, KBUILD announces the building of each index. 
For example: 

BUILDING INDEX 

After this index is built, the message: 

INDEX BUILT 

is displayed. When KBUILD has finished building the data subfile and 
all the index subfiles that needed to be built, it displ^s the 
message: 

KBUILD (XMPLETE, 

and control returns to HIIMDS (unless you are running I®Un,D out of a 
command file) , 



On page 3-32, the word "under" should be eliminated from the first 
sentence in paragr^ one. 



Section 5 Changes 

On page 5-3, the word OUTPUT on the second line from the bottom should 
be INPUT instead. 



Section 6 Changes 

On page 6-18, the description of the buffer argument incorrectly rea<fe, 
"The size of the data record buffer" when it should be sinply "The data 
record buffer," 

Also on page 6-18, it ^ould be noted that the bufsiz argument is 
alw^s supplied in wcards . 

On pages 6-21 and 6-31, the argument file-no was mistakenly emitted 
from the argument ej^lanation list. Please insert the following in 
between the index and bufsiz arguments on these pages: 

file-no Set this to 0: obsolete. 

On page 6-32, the description for FL$F3I incorrectly reads, "Tells 
FIND$ to the position to first entry.,," when it should read, "Tells 
FIND$ to position to the first entry,,.". The sentence should now read 
correctly. 

On page 6-49 , the argument listed as key value should be simply key . 
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On pages 6-52 and 6-58, the key argument was inadvertently emitted from 
the calling sequences, although it does appear in the argument 
ej^lanation lists on pages 6-53 and 6-59. Tte key argument should be 
inserted between the buffer and array arguments in these calling 
sequences. 



Section 7 Changes 

On page 7-18, delete the section STfiRT and Locked Records . 

On page 7-19, the phrase KEY IS should be inserted after PHONE-FILE in 
the example at the top of the page. 

Section 9 Changes 

On page 9-15, the second and third comment lines from the top of the 
page should be omitted. This program contains no on-units for the KEY 
condition (using an invalid key in a file access operation) , This is 
why the error messages shown in the outpit occur. To help clari^ 
this, the following sentence should be adfed before Reninders , on page 
9-15: 

"The error conditions are raised because there is no on-unit to 
trap KEY errors: see ERROR HfiNELING below." 

Section 12 Changes 

The information contained in the Note on page 12-11 is very irrportant. 
We' re mentioning it here to make sure that the note is not overlooked. 

Section 13 Changes 

Chi page 13-5, there should be a step 4 indicating that the read/write 
file locks on all MIDftS files should be changed to 2 {n readers and 1 
writer) vfcen disabling concurrent process handling. 



Section 14 Changes 

On page 14-2, the argument namlen does not have to be declared as 
INT*2, as implied in the book. This is the default however. 

On page 14-11, the statement under Why Use Offline Routines? claims 
that offline roitines are faster because they are not shared. This is 
only part of the actual story. Offline routines are not meant to be 
shared and therefore are not concerned with multi-user access to a 
file. Therefore they don't write out index blocks after each index 
entry is added to a file, as ADD1$ does. (Online routines must always 
write index blocks out to the file after each operation on the block so 
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that tiie file will not be damaged by concurrent access and so each user 
will have a consistent view of the file while accessing it, ) By not 
writing out the index blocks each time, a considerable amount of I/O 
overhead is saved, making offline routines faster than their online 
GounterEarts. In addition, the offline routines typass the concurrent 
process handling method which normally single-threads MIDAS use for 
online routines. Thus only one person can have access to a MIEftS file 
at a time when that file is being processed fcy an offline routine, 

C^ page 14-34 under ERROPN ; the funit argument should always be 
specified as a variable and not a constant, because it returns a value 
of if tiie call to EERQPN is unsuccessful. 



Section 15 Changes 

Page 15-8 discusses the EXTEND c^ion of CREATK as a method of making 
the iMex subfile longer. This method is pc^erable to the 
double-length index method which can also be used to lengthen an index 
subfile, users are urged to use the Exrmu option whenever th^ need 
to enlarge an index subfile. Please note this carefully, as it was not 
e:^licitly stated anyv*iere in the book. 



Index Changes 

On page X-9, some of the listings for KX$RPC and KX§TIM incorrectly 
refer to Section 4 instead of Section 14. 



Goieral Changes 

The file-no argctment, which appears in all of the FCliE?IEAN subroutine 
calling sequences, can, be set to any value the user desires. Currently 
the docuirentation infers that file-no ^ould be set to 0. This 
argument is ignored completely ty MIEftS and is being preserved only for 
compatibility. 
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Special CJiaracbers 

Replace page 1-12 by the following: 

Several characters reserved f ca: special use by BOWER cannot be included 
in descriptor names or filenames. These special characters are: 

. period 

, comma 

( left paroithesis 

) right parenthesis 

/ slash 

* asterisk 
+ plus 

- minus 

= equal 

< greater than 

> less than 

' single quote 

# pound (number) sign 
$ dollar sign 

! exclamation mark 

% percent sign 

Escape key (ESC on most terminals) 

Characters that do NOT appear in the above list, like colon (:) and 
semicolon (;) are assumed to be legal characters in both filenames and 
descriptca: names. 

Exceptions ; A few of the special characters listed above CfiN be used 
in KWER Tilenames . These characters are: 

period (.) 
minus (-) 
pound sign (#) 
dollar sign ($) 

For example, the names $TOIM. and ACCr# are legal POWER filenames, but 
they vrauld not be legal descriptor names. 

CREflTE Options 

Add the following to page 4-22: 

A MinAS search descriptor may not be added or have its data length or 
type changed with the CREftTE options. If you wish to make this kind of 
change (or wish to change a display descriptor to a search descriptor) , 
you should perform the following steps: 

1. Dump all data to a file. 

2. Destroy the original file. 
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3. Exit POWER and tredel the data file, 

4. Enter BCWER and recreate the file as desired, 

5. Batcdi add the data. 

If any descriptor names are being changed for the new file, these name 
changes should be made cm. the old file (using the CHANGE DESCRIPTOR 
option) . Otherwise, date in those descriptors will not be added. 

All structural changes to a file of any type that contain data should 
be made in the same manner. 



Redefining a MIDAS Index 

R^lace the description on page 4-24 with: 

The above example introduces a prompt displayed only vAien a MIDAS file 
is changed, A "NO" response should be given to the prompt "DOES 
MSCRIPTOR REDEFINE A MIDAS INEEX?", unless: 

• a search descriptor is deleted 

• a search descriptor's record position is changed. 

Change to LIST Canmand Syntax 

On page 6-5 the LIST command syntax is given as: 

LIST (file filename) 
It should read: 

LIST (formname -specification) 

Default Display Formats 

Change page 7-10 to read: 

Unless a user has created a heading for a file, all descriptors will be 
displayed using PCWER's default formats, as listed below: 

Data l!yTpe Default Display 

NUML (R*8) -ZZZZZZZ,## 

NUM2 (R*4) -ZZZZZZZ,## 

NUM3 (1*2) -ZZZZZ 

HJM4 (1*4) -ZZZZZZZZZZ 

NUMB (Decimal) -ZZZZZZZ.## 

NUM6 (OOMP-3) -ZZZZZZZ.## 
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If these default displ^s are now what is wanted, ycxa should create a 
heading (using HEADING CREATE) . 

Pr65 



Add the following to page 7-25: 



POWER now functions with the Prime Pres terminal. Users mupt initiate 
the downlcader (ty QA TERM) before entering POWER, As the PT65 
qperates in lew intensity mode, the low intensity visual attribute in a 
PCWER screen will not function. Entering this characteristic will have 
no effect on the screen. Also, fields must not begin before column 3 
in a PT65 screen. 



HEADING CREATE 

There is no reference in the manual to the query for desired numeric 
format if the descriptor is numeric. You should know tiiat unless you 
want the default display format for that data type, you must enter a 
format. A carriage-return response will result in the default 
displ^s. 
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MIDAS CEKNGES FOR 18.2 

The major changes to MIDAS for 18.2 involve organization of the product 
on the master disk and small naming modifications to comply v?ith new 
Prime software standards. These changes ircpact Section 13 of The MIDAS 
User's Guide under INITIALIZING MIDAS. Most of this information 
impacts the Administrator only, and should not affect most users. Any 
changes involved in installation of MIDAS can also be found in the INFO 
file on the master disk. 

CSianges to MIDAS Organization 

Pages 13-5 and 13-6 of the MIDAS manual list the names of all the 
sub-UFD's and command files that appeared in the MIDAS UFD up until Rev 
18.2. As of Rev 18.2, the following changes have been made: 

• Tte MIDAS ufd no longer contains ar^ source files or 
utility-building coninand files. These files, listed on page 



exists in a new ufd called MIDASSRC. Tl^ MIDAS ufd now contains 
insert files, share and install command files, plus the run 
f iles that exist in the sib-iifd's OMJCO, LIB, SYSCXDM, and 
SYSTEM. 

• The command files to install and share MIDAS remain the same, 
but build files have been rewritten in GEL and are now stored in 
MIDASSK:. The master file to build all of MIDAS is called 
MIDRS. BUILD, CHi and calls all the individual GPL files to build 
the MIDAS utilities. These GPL files are named 
CREAIK.BUILD.CEL, KBUILD. BUILD. GPL, and SO forth. 

• All source files in the the sub-ufd MIDASSROSOURGE conform to 
the new Prime suffix standard. All FORTRAN source files have 
the .FTO suffix, all FQRIE?AN insert files have the suffix 
.INS.FW, and so on. 

• For compatibility, all insert files in MIDAS and MIDAS>SYSCCM 
exist with and without the proper suffix, for example, PARM.K 
and FARM, K. INS. FTN. Use the versions with the new suffixes in 
future amplications. 

• The MIDAS utilities GREA3K, IMIDAS, KBUILD, KIDDEL and MPAGK do 
not accept command line arguments or options (and they never 
have) . They now report the message: 

NO COMMAND LINE ARGUMENTS POSSIBLE 

when a user attonpts to supply an argument upon invocation. 

• MCLUP now recognize when a user attonpts to use the "-USER ##" 
option more than once per invocation. 
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For FORDRM users Only 

Wten deleting entries from a MIDAS file through the F0R3RAN interface, 
flags should be used with care when making calls to NEXP$ before and 
after a call to DELET$, Some users have encountered concurrency errors 
(error 13) when they first call NEXr$ with FLAGS = FL$USE + FL$BES, 
then incorrectly call EELET$ with FLAGS = FL$USE, and finally call 
NEXr$ with FUGS = FL$USE + PL$RET. The error 13 haH»ns because the 
array being used on the call to NEXr$ points to a deleted entry. The 
correct way to perform this sequence is to: 

1. Call NEXr$ with FLAGS = FL$USE + FL$RET 

2. Call DELET$ with FLAGS = FL$USE + FL$RET 

3. Call NEXT$ with FLA3S = FL$USE + FL$EiET 

This pattern should be followed ejcept when deleting the first entry in 
an index. In such a case, FL$EIET should NOT be set on the call to 
EiILET$. Instead, FLPGS should be set to FL$Fffr ai the second call to 
NE5Cr$ to avoid problems. 
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THE FORMS PROGRAMMER'S GUIDE - IDR3040 



C3ianges to FOKB 



The FDL source line limit has been extended to 90 characters (from 72) . 
This implies that ar^ text that used to follow column 72 must now be 
commented, i.e. -Uie text must be ^Treceded b'' ^*, 

ETOi now supports the correct standard suffices, .POE^ for source, .EBIN 
for binary and .LIST for listing. 

FAP handles the standard binary suffix of .EBIN (see the EDL compiler) . 

TCB handling has been extended to allow (if required) machine unique 
TCB lists, instead of the standard systan unique TCB. This can be 
achieved ty copying TCB.BN from FORMS* and placing it in machine unique 
TCB* ufds. The original under FORPB* would then no longer be needed. 

The maximum user number allowed in the TCB list has been extended from 
64 to 128. 
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C3IM3GES TO NETCPG 

The changes shown belcw apply to Section 5, Network Caifiguration, of 
^JUne Primenet Guide, IDR3710 . 

Additional Public Data Network 

ERIMEINET iKJW supports the TYMNET public data netwcark. The name TXMNET 
is a correct response to the NETCPG dialog question, "Your national 
Public Data Network (H>N) ?" (Users who do not have PDN support do not 
see this NETCFG question.) 



NETCFG Changes for FAM II 

The dialogue for the Network Configuration program (NETCFG) has been 
modified to allow users to specify v^ether a node will use FAM I or FAM 
II remote disk access. A new question, "Enable FAM II?" has been added 
to the dialogue. 

The following is a description of the modified dialogie: 



Enable FAM II? 

YES Enable FAM II on this node. The remote node must also 
enable FAM II to you. NETCFG precedes to ask the Naming 
Sphere and Ring Password questions belcw. 

NO FAM II will not be enabled. NETCTG asks the Enable FAM I 
and Permit Remote FAM questions, below. 

Is this node in your naming sphere? 

YES Node is in the naming s0iere. 

NO Node is not in the naming sjiiere. 

Note 

This question is provided for future e35>ansion. Answer 
"YES" to this question. 

RingO-RingO password? 

A 32 character password may be specified for each FAM II 
node. Passwords may be changed with the NETCPG -PASSWORD 
option. This password is used to prevent unauthorized nodes 
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or software from naking FM II requests. Whenever FAM II 
services are initiated, the source node and password are 
checked against the configured FAM II nodes and passwords. 
If the match fails, FAM II service will be denied. 

A <cr> means no pasa^ord. 

Enable FAM I? 

YES Enable FAM I on the node. 

NO Neither FAM I nor FAM II is enabled for this node. 

Permit remote FAM to start disks? 

YES Allow the remote system adninistrator to add your disks. 

ND Do not allow the remote system adninistrator to add your 
disks. 



NEgPCFG -PASSWCM) Option 

Tlie Netwcark Configuration program (NETCFG) now supports a password 
nKSdification option. This allows users to create, delete or change 
passwords for all nodes in a specific netwcark without reconfiguration. 
The following is an exanple of the NETCFG -PASSWORD dialogue: 

OK, netcfg -password 

Review old network configuration? yes 

Rev 18.2 network configuration file 

Ring Net 

Nane Addr Ring ID FAM INFO RLOG 



*ME* QWERTY 1 

ASDF 2 II/SAME-NS Yes 

RingO-RingO password: GGJJG 

Do you want to update node passwords? yes 

Node name (CR if done)? asdf 
New RingO-RingO password? mnbv 

Node name (CR if done)? 

Review new network configuration? yes 

Rev 18.2 network configuration file 
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Ring Net 

Name Ac3dr Ring ID FAM INFO RLOG 



*ME* QWERTY 1 

^^ 2 II/SAME-NS Yes 

RingO-RingO password: MNBV 

OK, 
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INTOODDCPION 

Significant changes have been made to the DPTX product at Rev 18.2. 
The follcwing is a listing of these changes and the sections of "nhe 
DPTX Guide y IDR4035 that they iirjact: 

• Documentation correction to OWLDSC command — Section 2 

• Changes to TCP command — Section 2 

• Changes to TSF command — Section 2 

• Changes to the Block Device Interface (BDI) — Section 3 

• New OTTO^, DETX Startup, Warm Start, Multiline Hfi — Section 4 

CORRECTION TO OWLDS: OCWMfiND 

On page 2-9, no stars should aj^ar ar round the "USAGE:" n^ssage. The 
message itself should read: 

USftGE: OWLDK: [FAST] [NCLOCK] [REPORT] 

CHANGES TO DPTVTCF 

The following changes have been made to DPTVTCF (pass-through) for Rev 
18.2: 

• Changes in the TCP command line 

• Modifications for the use of the TEST REQUEST key 

• New connect time error message 

• New post-invocation error message 

• Multiple lines and general polling 

Use of ER2 and OEST REQUEST Keys 

Program Access key 2 (PA2) is now available for the QUIT function. In 
the command line: 
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TCF HC^T hname -^I?MINAL tname [-gJIT 'q-string'] [-PA m] [-W n] [-TR] 
the value of m may be 1 , 2, or 3 . 

The use of the TEST REQUEST key may be inhibited (not recognized) for 
sane terminals. This key is disabled in the DiPTX conf igaration when 
general polling is enabled for tiie control unit to which the terminal 
is attached. It is enabled if general polling is not used. 

New CCTinect Time Error Message 

The following message is new for Rev 18.2: 

Correct syntax is: 

TCF -HOST <host_name> -TERMINAL <term_name> [-EF <pf_key#>] 

[-Q[UIT] 'q_string*] 
<term_name> can be '*' {use this terminal). 
PF (program function key #'s 1-12 can be changed to 

PA (program access key #'s 1 thru 3) 
or TR (test request — no number needed) 
OK, 

The user failed to follow the correct ocraroand format. Reenter the 
command line. TCF returns the invoking terminal to ERIMDS contmand 
level after sending this message. 

New Post- Invocation Messages 

The following message is new to KTXACF as of Rev 18.2: 

HC^T not responding, returning to HlIfDS. 
OK, 

The following message is sent to the invoking terminal vAien the block 
mode virtual link to the terminal is broken and all attempts at 
recovery fail. The invoking terminal is returned to ERIKDS canmand 
level: 

Unable to retain terminal link, data possibly lost, 

returning to ERIMDS. 
OK, 

Multiple Lines and General Polling 

The traffic manager (OM) of DETVTCF now supports multiple ^nchronous 
lines and general polling, as described belcw for DPTX/ISF. 
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CHJM5ES TO TiPI^/TFS 

T3ie follcwing changes have been made to DPTX/teF for Rev 18.2: 

• Mtiltiple Synchronais Lines 

• General Polling 

Multiple Synchronous Lines 

DPTVISF can now be oonfigired for more than one synchronous line. 
Prior to Rev 18.2, caily ere line was supported. As before, a given 
synchronous line may have more than one control unit address 
conf icpred, that is, DPTVISF supports multidropping of IBM control 
units. 

Geieral Polling 

DPTXATSF has been enhanced to do general polling of attached IBM 

control units, in addition to specific polling. This has been 

implanented as a new option under SP3270. See the information on 
DPax:PG on how to configure general polling. 

Goieral polling is usually preferred over ^cif ic polling (viiich is 
the default configuration) , since general polling queries an entire 
control unit which responds if any of its devices has text or certain 
kir^ of status to send. In contrast, specific polling queries only a 
specific device. Use of general polling reduces the number of 
nonproductive "nothing to send" polls. 



CHfiNGES TO BLOCK DEVICE INTERFACE (BDI) CALLS 

The follcwing changes have been made to the Block Device Interface for 
Rev 18.2: 

• New BDKEYS insert files 

• Changes to BD$ATr, BD$SET, BD$INP and BD$INF 

• A new call, BD$LST 

BDKEys Insert Files 

Insert files for EL/I and assembler programs using the Block Device 
Interface (BDI) have been added to the UFD SYSOCM. SYSCOM now contains 
these insert files: 

BD$KEYS.INS.HN (for FORTRAN programs) 
BD$KEyS.INS.PLl (for PL/I programs) 
BD$KEys.INS.PMA (for PMA prograns) 
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BD$ft.TT; Attaching a device 

BD$ATT has a new code parameter, E$EHNA: 

E$PHNA: The Protocol Handler for this device is not active; call 
ignored, 

BD$SET: Set attributes for a Device 

Tte following changes have been made to the BD$SET call: a new set of 
keys and the inclusion of a new OODB parameter, E$IWST. 

Keys ; The current status of input/output operations performed ty the 
Protocol Handler on behalf of the BDI user. The current status of 
these operations, as they relate to these keys, may be determined ty a 
call to BD$INF. 

K$RSMI: (Default attribute) Enable input from the device. Ihis 
causes the Protocol Handler to resume normal input. Device 
input is autonatically enabled ty a "BD$ATT" call. (To 
preserve compatibility with earlier versions of the BDI, this 
key is functionally equivalent to BD$ENBD, and they are 
interpreted the same.) 

K$SPDI: Disable device input. The Protocol Handler will stop 
soliciting and/or accepting input for this (tevice. The user 
may continue to dequeue ar^ remaining device input (BD$INP) . 
(Again, to preserve ccmpatibility, this key is functionally 
equivalent to K55SBD in earlier versions of the BDI.) 

K$fiBTI: Abort device input. The Protocol Handler will cease 
soliciting and/or accepting input from the device (as for 
K$SFDI above). Additionally, at a time of its choosing, the 
Protocol Handler will drain the device input qireue to the 
user. Having completed this, it will reset the abort 
condition and leave the device input inhibited. While the 
abort is still in effect, the user may not reenable input ty 
neans of the K^ISMI k^^ above, however, once it has been 
reset ty the Protocol Handler, he may do so if he so chooses. 
TUne user should use this feature with care, as an abort 
flushes output statuses (T$TOK, T$TP: see BD$INP types and 
subtypes) as well as device inputs. In such an instance, the 
user mi^t well be unaware of which messages were sent to the 
device, and which were rejected (if any) . Note that an input 
abort is entirely independent of the output abort condition 
described below. 

K$RSM3: (Default attribute) Enable output to the device. The 
Protocol Handler will resume sending output from the user 
output queue to the device. Itds option is automatically 
enabled by the BD^TT call. 

K$SPDO: Disable output to device. The Protocol Handler will cease 
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dequeuing messages frcm the user output queue to outEHit. The 
user may continue to queue (BD$CUT) output to the device 
(until the queue becoires full) , but no output will be sent to 
the device until output is reenabled ty a BD$SET call of 
K$RSMD. 

K$RBTD: Abort output, THas Protocol Handler vdll cease dequeuing 
messages f ran the user output queue to send to the device (as 
f or K$SHX), above). At a time of the Protocol Handler's 
choosing, it will drain the output queue form the user of all 
messages (no indication of how many messages are drained is 
given) , reset the abort condition, and leave output to the 
device inhibited. While the abort condition exists, the user 
may rrat queue any additional outputs {BD$CUT) nor may he 
reenable output to the device. When the the abort condition 
has been cleared, as can be determined by a call to BD$INF, 
the user may then reenable output and/or queue output as he 
sees fit. Note that the output abort condition is entirely 
independent frcm the input abort condition described above 
(except as affected by the Protocol Handler) , 

K$I1WT: Enable the "input waiting" condition for BD$0[JT, If the user 
attempts to oatput (BD$OCJT) to a device vhidh has input 
waiting for him, the attempt is rejected and an error code of 
E$INWT is returned. This condition may also be enabled at 
configuration time, in which case the user may not enable or 
disable it (a return code of E$INWT is given, and the call is 
ignored) , 

1 

K$IW)F: (Default attribute) Disable the "input waiting" c»ndition on 
BD$CUT. The user may queue output to the device Protocol 
Handler regardless of the presence of any device input 
awaiting his acceptance. Ihis condition may be enabled at 
device configuration time, in which case the user may not 
disable it (an error code of E$IWST is returned) . 

K$PA2P: Disable DPTX Support Traffic Manager (STM) trapping of the 
PA2 k&f. DPTX-^TSF uses the PA2 key as a "quit" or "break" 
k^, which, if depressed while "quits" are enabled, causes an 
inmediate return of the user's process to ERIMDS command 
level. If the PA2 trap is disabled, the PA2 key will not be 
recognized as a "quit" key by the STM, and will be passed 
through to the user program while that device is in block 
mode. K$PA2P is invalid fca: any other protocol. 

K$PA2Q: Enable the aforementioned trap of the PA2 key by the DPTX 
Support Traffic Manager. K$PA2Q is invalid for any other 
protocol. 

K$RaWD: Send the data in data (and the fields in outarr ) to the 
Protocol Handler for transmission to this device without 
checking the validity of that data, or performing ai^ 
translations on it. TMs key will be rejected (at the BDI) 
for devices whose Protocol Handlers do not accept such data. 
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Code ; The cxsde description is: 



E$IWST: "Iiput waiting" condition enabled in configuration; call 
ignored. 



ED$INP! Input front a Device. 

The following changes have been made to the BD$INP call: 

• A new ke^ value, K$WfllIT 

• A new code error value, E$BH?H 

• A new argument, period 

CALL BD$INP (device, key, data, length, inparr, code , period) 

K^ATT: wait until sane input is available and return with it, or 
until the specified time limit ( period — tenths of a second) 
is exceeded and return with an error code of E§NINP if no 
input is available. 

E$BH?H: Bad protocol handler defined in configuration, 

period A time period specified ty the user to indicate the length of 
time to wait for input before returning to the user if no 
input is at hand when the call is made. This value is 
ej^Jressed in tenths of a second, and is only examined when a 
key of K^APT is specified. In this manner, BD$INP remains 
compatible with earlier versions vhidn. did not have this 
capability or parameter. If the value is less than or equal 
to , it is equivalent to making the same call with a key of 
K^AIT. If the time period runs out and no input is received 
an error code of EI^INP is returned. If input is available, 
the data is returned to the user, without any indication of 
how Icaig the wait was. 

BD$INF; Information about a device 

The following changes have been made to BD$INF: 

• A new key value, K$INFS 

• Redefinition of the infarr array 

K$INFS: BD$INF will return static device data in wcards one through 4 
of infarr . The contents of data are left untoudied. 

infarr: A ten-word array to be filled with information about the 
device: 

For ke^ = K$INEN cc K$INFD: 
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vacd 1: Protocol type of this ^vice, 
0: undefined 

1: DPTV^ESF {3270 Terminal Support) 
2: DPTVDSC (3270 Emulation port) 

word 2: Device status and configuration bits. 



The configuration bits are set at configuration 
tirre (the DPTX command at the systan console) . 

bit 1-10: Reserved. 

bit 11: Physical status: 1 = up, = dovm. 

bit 12: "input waiting" condition for BD$CUT 
enabled by configuration. If true (= 1) / 
the user must retrieve (ED$INP) ai^', input 
data from the device queues before 
sending ar^ output (BD$CUT) . 

bit 13: Input allowed from device. If true, the 
protocol handler will solicit (or accept, 
as appropriate for the protocol) input, 
provided the user has not inhibited it 
(see below and BD$SET) . 

bit 14: Output allowed to device. If true, the 
protocol handler will send user output 
(queued through BD$CUT) to the device, 
provided the user has not inhibited it 
(see below and BD$SET) . 

bit 15: Block mode allowed. The user may attach 
this device in block mode. (This is 
somewhat redundant as the user must be 
able to attach the device if he is to do 
the BD$INF call.) 

bit 16: Prime standard terminal. This device m^ 
be used as a command device (i.e. the 
user may converse with ERIMDS through 
it). 

word 3: Maximum input and output buffer length defined for 
this device. This is the maximum value of length , 
which is acceptable on a BD$CXJT call with key of 
K$XtOT). It is also the largest size in characters, 
vdiich any input fran this device can attain. The 
user program should provide an input buffer of at 
least this length on BD$INP calls to ensure enough 
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room for the maximum sized message. 

word 4: Character codes used by the device (bits 1-8) , and 
the user (bits 9-16) . 

0: ASCII 

1: EBCDIC 

The user can control the value of the latter (user 
character code) through the use of the BD$SET call 
(keys of K$RSCD — ASCII and K$EBCD — EBCDIC) . 

word 5: User alterable device enable/disable status. The 
user may indirectly control the input and output 
data streams from the Prctocol Handler to the 
device and to the user b calls to the BD$SET 
routine. Ihis word describes the current status of 
those requests. 

bit 1-10: Reserved. 

bit 11: PA2 key DPTX-OSF Support Traffic Manager 
(STM) trap disabled. OMs indicator is 
not valid for non-DPTX-ZESF command 
terminal devices. when false (= 0) , the 
s™ will tr^ the PA2 key on input from 
such a device, signal a "quit" condition, 
and not pass the key to the user program. 
Viben true (= 1) , the STM wHl pass the 
PA2 key to the user program exactly as it 
would any other device input. 

bit 12: Ir^ut waiting condition enabled. If this 
bit is turned on (= 1) (or bit 12 of word 
2 above) , the user must retrieve device 
input, if any, before sending output 
(BD$aJT) to the device. This setting 
only has effect if the "input waiting" 
condition was not enabled in the 
configuration. This bit is altered by 
calls to BD$SET with keys of K$IW0N 
(condition enabled) and K$IWOF (condition 
disabled) . It is disabled when the user 
attaches (BD$ATT) the device. 

bit 13: Abort Transmit in progress. If true 
(= 1) , the user has requested (BD$SET) a 
trananit abort at some earlier time, and 
it is still in progress. Input from the 
device is inhibited. At some later time, 
the Protocol Handler will drain the 
device input queues and reset the abort 
condition. The user may not re-enable 
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(BD$SET) device output until tiie abort 
has been completed. Further, the user 
may irot queue (BD$COT) output for the 
device while the abort is in progress. 
However, when the abort condition has 
been cleared, the user may queue output, 
even thcwgh output is still disabled, at 
least until the output queue to the 
Protocol Handler fills up. 

bit 14: Receive Abort in progress. If true (= 1) 
the user previously requested (BD$SET) an 
input abort for this device, and it is 
still in progress. At some later time 
the Protoc»l Handler will drain the 
device input queue and reset the abort 
condition. Device in^Hit is disabled, and 
the user may not re-enable (BD$SET) it 
until the abort condition has been 
cleared. However, the user may dequeue 
(BD$INP) remaining device inpit from the 
queues while the abort condition is in 
progress. 

bit 15: Output suspended. If true (= 1) , the 
user has previously requested (BD$SET) 
either a trananait abort or suspension. 
While output is suspended, the Protocol 
Handler will not send any output to the 
device. However, provided a trananit 
abort is not in effect, the user may 
queire output (BD$CUT) for the device 
until the device output queue fills up. 
The user may reset (BD$SET) this 
condition provided a transmit abort (see 
above and BD$SET) is not in progress. 

bit 16 : Ir^ut suspended. If true (= 1) , the 
Protocol Handler is not accepting input 
from the device. "flie user disabled 
device input ty a previews call to 
BD$SET. The user may retrieve (BD$INP) 
any remaining input from the device input 
queue while tiie input is disabled. The 
user may re-enable (BD$SET) device input 
provided an input abort is not in 
progress. 

word 6: (reserved) 

worcfe Protocol-specific status information, if any. See 

7-10: DPTX/DSC Specific Information and DPTX/esf Specific 

Information in Section 3 of The Distributed 

Processing Terminal Executive Guide, IDR4035, for 



July 1981 



SECTION 8 MRUS 

details for some Prime-supplied protocols. 
For ke^ = K$INFS: 
word 1: Device type: 

0: terminal 

1: printer 

This is presently used for 3270 printer anulation 
(as part of nPTVt>SC) and support (as part of 
DPTVlSF) and indicates the type of device rather 
than the Protocol Handler. 

word 2: Device type flags: 

bit 12 = 1: "input waiting" condition enabled (in 
configuration) . 

bit 13 = 1: input allcwed from device. 

bit 14 = 1: output to device allowed. 

bit 15 = 1: block mode allowed. 

bit 16 = 1: this device is a Primes terminal. 

word 3: Screen size: Maximum physical buffer size (bytes) 
of the device, 

word 4: Protocol type: 

0: undefined 

1: DPTVESF (3270 Terminal St^jport) 

2: DPTX/DSC (3270 Emulation port) 

words (reserved) 

5-6: 

wca:ds Protocol-specific status information, if arr^. See 

7-10: DPT)0DSC Specific Inf carnation and DPTVTSF Specific 

Information in Section 3 of The Distributed 

Processing Terminal Executive Guide , IDR4035, fear 

details for sone Prime-supplied protocols, 

ED^ST: List BDI Configuration Data 

caUi BD$LST(key, name, nameln, datbuf , datlen, code ) 

This is a new call. It fetches information about the current DPTX 
configuration as maintained by the Block Device Interface. 
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key 



name 



Indicates the type of infonnation requested by the user. 
This argument is referenced but not altered by BD$LST. 



K$INFD: 



K$INniI: 



K$LTM": 



Infonnation (as described below) about a specific 
device vAiose "name" is specified in name is 
returned in datbuf . 



KgLEAT: 



Infonnation (as described below) about a specific 
device whose logical station ID is specified by the 
caller in datbuf (1) is returned in the ranainder of 
datbuf and in name . 

A list of the logical station ID numbers which 
correspond to devices residing on the logical 
synchronous line specified in datbuf (1) is returned 
in the remainder of datbuf . 

A list of the logical Poll Group numbers which 
correspond to poll groups (CUs) residing on the 
synchronous lirte specified in datfcuf (1) is returned 
in the ranainder of datbuf. 



K$PrAr: 



K$PATD: 



K$BSYS: 



A list of the logical station ID numbers 
corresponding to devices in the poll group 
(attached to the CU) whose logical poll group 
number is specified in datbuf (1) by the user is 
returned in the ranainder of datbuf . 

A description of the poll group whose logical poll 
group number is specified in datbuf (1) is returned 
in the remainder of datbuf . 

Get system data. The total number of poll groups 
and the total number of devices in the 
configuration, the identification of the protocol 
handler and the number of devices and the number of 
poll groups on each line is returned to the caller 
in datbuf . 

The name of the device for ke^ = K$1NFN and K$INFD. For kejj; 
= K$INFDr the name must be specified and must exist in the 
Tiff definition tables. For ke^ = K$INEN, as many characters 
(left justified, blank filled) of the device name as will fit 
(as specified in nameln ) are returned to the user in name . 
If the device name must be truncated, a code of E$BPIS 
(buffer too small) is returned. The user is not informed of 
the actual name length. BDI device names are a maximum of 32 
characters long. For K$INFN, if nameln is specified as zero, 
name is left unaltered. For all other values of key; this 
flild is unaltered and not referenced by BD$LST, the user may 
therefore specify it as he wishes, but it may not be omitted. 

nameln The length of name in characters. Specified by the user. 
For keys of K$INFN and K$INED, this argument is referenced 
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but not altered. For other values of ke^, this argument is 
not referenced, 

datbuf An array of returned data, the contents of which vary 
depending on the key specified, 

K$INFD The device specified fcy name is 

K$INEW described in datbuf . If code = E$BDEV (device not 
found) , the contents of this array are invalid. 

word 1 Logical station id of the device. 

word 2 Protocol type: 

1 = DPTX Terminal Si;{>port 

2 = DPTX Data Stream Ccmpatibility 
word 3 Device type: 

= terminal 

1 = printer 

word 4 Station capabilities (bit encoded) : This 
word is exactly tiie same as INFARR(2) 
returned from a call to BD$INF with a key of 
K$INETSI or K$INFD, 

bits 1-11: (reserved) 

bit 12: Read before write required. 
Iiput allowed from device. 
Output to device allowed. 
Block mode deration permitted. 



bit 13 

bit 14 

bit 15 

bit 16 



Prime Standard Terminal (DPTX-TSF 
only). 



ward 5 Maximum buffer size of the device. 

ward 6 Maximum message size defined for the 
device's protocol, 

word 7 Physical device character set: 

= ASai 

1 = EBCDIC 
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word 8 Station status: 

1 = offline 

2 = device marked down by protocol handler. 

3 = device operational, 

word 9 Owner's process number (if zero, the device 
is not owned) , 

word 10 Device address (ward 1) in that device's 
physical character code. (For DPTX, only 
the lower tyte is valid, and is the EBCDIC 
representation. ) 

word 11 Device address (word 2) in that device's 
pi^sical character code. (For DPTX, csily 
the lower tyte is valid, and is the EBCDIC 
representation. ) 

wocd 12 Pl^sical station identification: 

bits 1-8 Logical line number (for 
synchronous lines, this value is in the 
range 0-7) . 

bits 9-16 Logical poll group nianber. 

word 13 Printer information (not valid for devices 
other than printers) : 

bits 1-8: Platen length. 

bits 9-15: (reserved) 

bit 16: Vertical Forms Caitrol on. (DPTX 
3270 products only) 

word 14 Maximum output queue length. 

word 15 Maximum input queue length. 

K$LTAT List all the logical station IDs corresponding to 
devices residing on the synchronous line (0-7) 
specified in datbuf (1) . If datlen is less than two, 
no processing is performed for this call except 
identification of the key, and a code of E$BPAR is 
returned, 

datbuf (1) The synchronous line number. Supplied ty 
the caller, this is not altered ty 
BD$LST. If its value is aitside the 
permissible range of synchronous lines, a 
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cxxae of E$BDEV is returned to the user. 

datfcuf (2) The number of block devices configured on 
the specified line. 

dattuf(3...) The logical station IDs of the devices on 
this line. If datlen indicates a buffer 
too small to hold all the ids, this list 
is truncated at the last one v^ich can 
fit in datbuf , and a code of E$BFTS is 

exceeds the size 

ranainder of datbuf is 
of entries 



returned, 
required. 



If datlen 
the 
valid only up to the number 



specified in datbuf (2) (i.e. if datbuf (2) 
equals one, datbuf (4) through 
datbuf ( datlen ) are invalid). 

K$LPAT Return a list of all the poll groups defined on the 
synchronous line specified in datbuf (1) , If datlen is 
less than two, no processing is performed for this 
call other than the identification of the ke^, and a 
code of E$BPflR is returned. The returneFvalues are 
similar to those specified for K^TfiT. 

datbuf (1) The synchronous line specified fcy the 
user. This entry is not altered ty 
BDSlst. If it lies outside the 
permissible range of synchronous lines, 
no further processing is attempted, and a 
code of E$BDEV is returned. 

datbuf (2) A count of the logical poll groups 
residing on the su'nchronous line 
specif ied in datbuf (1). if 0, this 
indicates that no block device poll 
groups are defined on that synchronous 
line in the current configuration. 

datbuf (3...) A list of the logical poll group numbers 
corresponding to poll groups defined on 
the synchronous line specified in 
datbuf (1) . If datlen indicates a buffer 
too small to hold all the IDs, this list 
is truncated at the last one which can 
fit in datbuf, and a code of E$BPrs is 
returned. If datlen exceeds the size 
required, the remainder of datbuf is 
valid only up to the number of entries 
specified in datbuf (2) (i.e. if datbuf (2) 
equals one, datbuf (4) through 
datbuf ( datlen ) are invalid). 

K$ETAr Return a list of the logical station IDs corresponding 
to the devices associated with the poll group whose 
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logical ID number is specified in datbufd). If 
datlen is less than two, no processing is performed 
for this call other than the identification of the 
key , and a code of E$BPfiR is returned. 

datbufd) The logical poll group number. Supplied 
fcy the caller, this is not altered ty 
BD$LSr. If its value is outside the 
permissible range of poll group numbers, 
a code of E$BDEV is returned to the user. 

datbuf (2) The number of block devices configured 
for the specified poll group. 

datbuf (3...) The logical station IDs of the devices on 
this poll group. If datlen indicates a 
buffer too atiall to hold all the IDs, 
this list is truncated at the last one 
which can fit in datbuf, and a code of 
E$BETS is returned. If datlen exceeds 
the size required, the rsnair^er of 
datbuf is valid only up to the number of 
entries specified in datbuf (2) (i.e. if 
datbuf (2) equals one, datbuf (4) through 
datbuf (datlen) are invalid). 



K$PATD Return a description of the logical poll group. If 
datlen is less than two, no processing is performed 
for this call other than the identification of the 
key , and a code of E$BPAR is returned, datbuf is 
filled only up to the minimum of datlen or six 
elements. If datlen is less than six, a error code of 
E$BFTS is returned, but the array is filled up to and 
including the last element as described below: 



datbufd) Logical poll group number. Supplied ty the 
user. If this valie is outside the range 
configured, a code of E$BDEV is returned and 
no further processing is enacted. 

datbuf (2) Poll group type: 

1 = DPTX 3270 Terminal Si5>port 

2 = DPTX 3270 Terminal Emulation 

datbuf (3) The number of the synchronous line upon 
which this poll group resides. 

datbuf (4) The number of logical devices defined to be 
associated with this poll group. 
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datbuf (5) The poll group status: 

1 = Undefined (offline) 

2 = Marked dovm fcy protocol handler 

3 = State is unclear, potentially up 

4 = Operational 

datbuf (6) Poll group address. For DETX, only the 
lower six bits of this address are valid. 

K$BSYS Return s/stan data. This key requests general 
information about the current configuration. If 
datlen is less than oite, no processing is done beyond 
the identification of the key , and a code of E$BPAR is 
returned. A maximum of datlen or four times the 
number of ERIMDS configured synchronous lines plus two 
{ 4 * (# synchronous lines) + 2) parameters are 
returned, v*iichever is analler. Currently, the number 
of IRIMDS-configured syrchronous lines stands at 
eight. If datlen is the smaller, a code of E$BFTS is 
returned. If datlen is the larger fi^re, the 
remainder o£ datbuf is untouched. 

dathuf (1) The total number of block devices 

configured. 

datbuf (2) The total number of poll groups 

configured. 

datlxif (3, 7, 11...) The protocol type of the protocol 

handler on this line. If this 
parameter has the value 0, no 
protocol handler is presently 
operating on this line. 

1 DPTX 3270 terminal support. 

2 DPTX 3270 terminal anulation. 

datbuf (4, 8, 12...) The HlIMOS user number of the 

protocol handler on this line, 

datbuf (5, 9, 13...) The number of block devices 

defined on this line, 

datbuf (6, 10, 14,..) The number of poll groups defined 

on this line. 

This last set of datbuf parameters is most easily described 
in terms of a ELI -like data structure: 
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DCL 1 SYBINFO, 

2 TOaifiL_JM7ICES fixed bin (15) , 

2 TOTA[Jo:iL_GRajPS fixed bin (15) , 

2 PER_LINE_raSC (M]rBER_SYNCHRCNCDS_LINES) , 

3 PHJKFE fixed bin (15) , 

3 PH_USER_NO fixed bin (15) , 

3 LINEJDEVICES fixed bin (15) , 

3 L3NE_H)LL_GRaJES fixed bin (15) ; 

datlen The size of the arr^ databuf (wor^) . 

code The value of this parameter indicates the success or failure 
of the call, and the reason for the latter if it occurs. 

0: Action performed, all specified paremeters returned 

as defined. 

E$BFTS: nameln was too small (key of K$INFN oily) , or 
datlen was too anall (all keys) to contain the 
data. 

E$BEAR: datlen was too small to even begin processing the 
request, 

E$BI.EN: nameln was less than for a kej^ of K$INEW, or less 
than or equal to for a key of K$INFD, 

E$DNAV: Device not found in configuration tables ( key = 
K$INro) . 

E$BKEY: key not recognized. 

E$B^WD: For a key of K$INFN or K$INED, the value of datlen 
was specified as less than 0. 

E$BDEV: The device number ( k^ = K$INnsi) , line 
number ( key = K$LTAr or I^PAT) , a: poll group 
number ( key = K$PATD or K$PrAT) specified by the 
user in " ^tbuf (1) was outside tiie range defined in 
the current configuration. 

E$DNC No BDI configuration has yet been done. 



The following example may serve to illustrate tiie use of this entry: 

INTBGER*2 nATA(15) , COCE, I 
$INSERT SYSCX)M>KEyS.F 
$INSERT SyKX»[>BDKEyS.INS.PlN 

CALL BD$LST(K$INFD, 'MyjDEVICE' , 9, DATA, 15, CODE) 

IF (CODE .NE. 0) GO TO 100 

WRITEd, 50) (DATA(I), 1=1, 15) 
50 FORMAT (// ' Description of My_DEVICE : ' , 
+ /'Logical Station ID:', 12, 
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+ /'Protocol type:'r 12, 

+ /'Device types', 12, 

+ / 'Configuration bits : ' , 12 , 

+ /'Devicje buffer size:', 15, 

+ /'Maximum message size:', 15, 

+ /'Physical device code:', 14, 

+ /'Device status:', 12, 

+ /'Owner user ID:', 12, 

+ /'Device address:', 214, 

+ /'Line and CU numbers:', 18, 

+ /'Printer information (?):', 14, 

+ /'Maximum output queue length:', 12, 

+ /'Maximum input queue lengtii:', 12//) 

STOP 
100 CALL ERRPR$(K$NRIN, CODE, 'We blew it!', 11, 'DEMD' , 4) 

STOP 

END 



DPECPG: THE DETX CONFIGURATION 0C»1PILER 

This section describes the user interface to the EPTX configuration 
compiler (DETCPG) as of Rev 18.2. Included are descriptions of the 
command line, and the scHarce level input to the ccanpiler. A complete 
catalogue of the error and warning message follows. 

Substantial changes in the functionality of this product have been made 
for Rev 18,2, and the progran itself has been entirely rewritten. This 
section should be carefully read before using the Rev 18,2 DFPCEX;, 



Introduction 

DPTCFG is an external command used to invdce the EPTX conf igiration 
compiler. The principal function of this program is to translate a 
source input file describing the physical configuration (as seen ty 
DPTX) of IBM 3271 compatible devices and "host" machines into a ccmpact 
configuration table which is output as a "binary" file. Tliis latter 
file is then loaded into the system when DETX is initialized. 

Several other options have been provided that yield a better user 
interface. One m^ now reverse the compilation process, producing a 
source file from a compiled binary. This will be of some use ^ould 
the user wish to determine the contents of a binary file and not have 
access to the corresponding source file. lUnere is the further 
advant:age that ^ould the format of the binary file change to 
accommodate future changes in DPTX, one may reverse the compilation of 
the binary files with the "old" version of DPTCEX; and then reccsnpile 
with the new version. 

An option to generate a tabular description of a configuration at the 
user's terminal and/or into a file has been added. As the binary file 
format was never intended to be particularly user visible or 
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interpretable, this will enable the user to inmediately confirm the 
cxintents of a particular configuration. A tabular format is also 
considerably easier to read than the topical source file. Coupled with 
this is an option to suppress binary/source file output. 

Lastly, an error listing file generation option has been added, TMs 
output file has an appearance similar to the output listing files of 
the more familiar language translators (FTO, Hj/1, etc.), and it lists 
the input source statements interspersed by ^plicable error and 
warning messages (if any) . TMs tends to alleviate some of aggravation 
caused by the error message handling of the previous product. 



Command Line Syntax 

The DPTCPG command line is of the form: 

DPTCFG input_treename ojtions 

where input_tr eename is the treename of the input file, whether source 
(viien -EEViKSE IS emitted) or binary (v^en -REVEE?SE is present) see 
belcw. 



Valid options are: 

-OUTPUTFILE treename Specify the output treename that is to be 
-OUTPUT treename used for the configuration file (if -REVEE^SE 

is not specified) or source file (if -REVHISE 

is specified) . 



-NO_CUTPUT 
-NOUT 



Do not generate an output file (a conf igurar- 
tion file if the -REVEKSE option is not 
given, a source file if it is) , Obviously, 
-OUTPUT and -NO_0UTPUT are mutually 
exclusive. 



-EERLIST treename 
-EE?EL treename 



Specify the file to contain an error listing. 



-REVERSE 



-LIST treename 
-L treename 



-TTJf [screen_length] 



Use the configuration file as input and 
generate a source file as output (the latter 
is inhibited if -NOjOUTPUT was also 
specified) . 

Produce a tabular description of the config- 
uration, and place it in the file specified. 

Produce the same tabular description as for 
-LIST (above) , except output it to the user 
terminal, (The program stops outputting data 
to the terminal after a full screen of data 
has been output, after a full group or after 
several groups if they will all fit on the 
screen at one time, and then prompts the user 
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for a termination (Q or QUIT) or continuation 
(arything else) .) screen_length defaults 
to 23 lines, and must not be less than 9. 

The options -EEM3R and -REVERSE are mutually exclusive. Pathnames 
follow the file naming standards. The following file suffixes are used 
hf DPFCPG: 

.DETCE1G source file 

.CONFIG binary file 

.ERROR error listing file 

.LIST displ^ listing file 



The input treename must be present. If ary option requiring a treename 
(-CUTPUTFILE, -EERLIST, -TIY) has no treename specified in the caramand 
line, that treename is inferred from the input treename 

The default actions for DPTCPG are to generate a configuration output 
file using the same base name as the source input file, and to suppress 
error and display listing generation. 

Should the command line contain an error, DPTCPG will not process the 
input file, nor write any of the output files. Similarly, if there is 
an error in the input file, DPTCEXS will not write any output file, with 
the exception of the -ERRLIST file (if specified). 

An Example 

The following examples are intended to illustrate the more ccanmon uses 
of DPTCPG. 

DPTCPG MXFILE 

DPTCPG will search the current UFD for tiie file MSfFILE. DPTCPG, if this 
search fails, the file MXFILE will be searched for, Slxjuld both 
searches fail, DPTCPG will terminate with an appropriate error message. 
The file which is found will be used as the source input, 

DPTCPG will then open the file MYPILE, CONFIG (creating it if necessary) 
and use it for binary output. Error messages (if any) will be sent to 
the standard user output stream. When compilation is conplete, a 
message such as "0002 ERRCKS (DPTCFG Rev, 18.2)" will be output. 



Another Example 

DPTCFG MYFILE -OUTPUT FOO -EERL -TTY -LIST FOOBm 

The source input file will be searched for as above. The binary output 
file FOO will be opened. As the input file is ccmpiled an error 
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listing file (MYFILE. EERCR) is produced, listing eadi source statanent 
and its line number, followed ty any error messages pertaining to it. 

If the source file is fault-free, DPrCFG will output a tabular 
description into a listing file (FCXBM) vdien the compilation is 
complete. When this has finished, a similar table will be output to 
the standard user output stream (CCMXJTPUT file and/or user terminal) 
using the interaction previously described. 



DPPCPG SOURCE FILES 

The two major dianges to DPTCPG source file grammar at Rev 18.2 are the 
addition of the ENABLE GENERRL_EOLL statanent, and the elimination of 
the need for device and group numbering. Device and group numbers are 
no longer required, and their use is discouraged, but DPTCPG will check 
them, if present, for correctness. See DPTCPG Warning and Error 
Messages, belcw. 

Source Inout File Grammar 

Lines in a DPTCPG source file are parsed (for the iiost part) according 
to the rules for the operating systan routine RnrK$$. One notable 
exception is that a decimal number specified as the dDject of a keyword 
may be entered either as a string of decimal digits or as a colon 
followed by a string of octal digits. In the latter case, the octal 
number su^^lied will be appropriately coiwerted to its decimal 
equivalent, 

t^iper and lower case are not differentiated and may be used 
interchangeably. The source file consists of series of structured 
blocks, each om defining an individual group, vdiere a "group" is 
equivaleit to an IBM 3271 control unit, whether real or anulated. A 
group definition contains exactly one "Define group" statanent, 
followed by a variable number of "Define device" statanents. Both of 
these statanents are followed ty a variable number of keywords whidi 
specify attributes (e.g. address CI) . A statanent is terminated by the 
next occurrence of a major command, or the end of the file. Blank 
lines are ignored in statanent parsing, and their use is encouraged for 
clarity. The basic block structure is outlined below: 

DEFINE GROUP 

k€yword_attributes 
DEFINE DEVIO: 

keywor d_attr ibut ^ 
DEFINE EEVICE 

keywo: d_attr ibutes 

The total number of groups and devices must not exceed the constraints 
specified hy DPTX (currently these limits are 32 groups and 32 devices 
in ai^ combination, with the obvious restriction that a device must be 
associated with one — and only one — group) . DETX at Rev 18.2 
supports no more than 32 devices, total. 
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Major Statement - DEFINE GRCUP 

This statement must precede ar^ definitions for devices, and must be 
iiimediately followed by the "DEFINE lEVICE" statanent for each device 
in the group. The format of the statement is: 

DEFINE GROUP keyvrord_at tributes 

The following keyword_attributes are required and will generate an 
error if not present: 

PROODOQL {EM3270 I SP3270} 

Specifies the type of service (Emulate or Support) for which 
devices in this group are to be used, EM3270 specifies that the 
devices are virtual 3277 terminals to be emulated, and SP3270 
specifies that the devices are 3277 terminals to be supported. 
Protocols m^ not be mixed on the same s/rchronous line. 

LINE n 

Specifies the logical line number of the synchronous line which 
this group is on. n is currently restricted to the ranqe 
thru 7. 

ADmESS nn 

Specifies the address of this group. The address must be 
specified as a two digit hexadecimal number which represents an 
EBCDIC character. For a list of valid addresses, consult the "IBM 
3270 Information Display System Component Description" (IBM 
publication GA27-2749) . 

The follcwing keywcard attribute is optional: 

HUfiBLE GENERfiL_Pa[iL 

This keywcard specifies that particular operations or modes of 
operation are enabled for a particular control unit. Currently 
there is only one option, and it is restricted to SP3270 control 
units. If not specified, the default is to disable general 
polling by DPTX to SP3270 control units. 

Enabling general polling on SP3270 control units allows DPTX-TSF 
support to general poll that control unit. This usually results 
in a vast reduction in non-productive line traffic, vdiich yields a 
significantly higher throughput for terminal I/O bound 
applications. The sole disadvantage to using general polling on a 
control unit is that the Test Request key on ai^ terminal attached 
to that control unit will be ignored by DPTX-TSF. When this 
occurs input will be inhibited until the terminal operator resets 
the keyboard. Under DPTX-TCF, the IBM host may also reset the 
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keyboard, but this latter is entirely dependent on the host's 
progranming. 

Major Statement - DEFINE DEVICE 

This statonent specifies the attributes associated with individual 
devices in a group. The format of the statement is: 

DEFINE DEVICE keyword_attributes 

The following keyword_attributes are required: 

NAME 32 character name 

Specifies the name of this device for Block Device attaches. The 
first character must be a letter, and the remainder of the name 
should follow the HIIMDS standard file name conventions for non 
wila-card names. 

ADDkESS nn 

Specifies the device address, nn is interpreted the same as in 
group addresses. 

The following keyvord_attributes are optional: 
USER n 

(Only legal for terminal devices in groups for which the SP3270 
protocol has been specified.) Specifies the user number 
associated with this device when it is used to issue commands to 
ERIMDS, 



Note 

There must exist Primos terminal buffers associated with 
this user number (i.e. the Primos configuration file must 
specify the number of terminal users such that it includes 
the users specified for all TSF devices). Further, 
processing of the characters in these terminal buffers by 
the Primos AMLC process must be disabled to prevent the 
loss of characters (enter AMLC TTYNOP line number where 
line number is the octal representation of the MLC line 
number ( nn - 2 ) normally associated with this user 
process. See The Systgn Adninistrator's Guide , PDR3109, 
for further details on the AMLC command. 

MABLE list_of_enable_options 

Specifies the operations which may be performed on this device and 
the modes of access to the device available to the user. This 
keyword and its associated options are illegal for a printer 
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REM): The device may be read from 

WRITE: The device xaay be written to 

BLOCK: The device may be maniptaated ky Block Device calls 

CCWMfiND: Tte device is to be considered a user terminal, for 

command input to Primos. This option is only valid for 

terminals in a SP3270 group. 

If ENABLE is not supplied ty the user, DPTCPG supplies the 
defaults READ, WRITE and BLOCK for EM3270 terminals and SP3270 
terminals for which USER has not been specified. Should the user 
specify the USER option for an SP3270 device, the ENABLE option 
defaults to READ, WRITE and CC»mAND if not specified. READ and 
WRITE must be enabled on a SP3270 CCBMAND terminal. 

PRINTER IVPC I PLATEN nnn] 

Specifies that tiie device is a printer. The c^ions VFC and 
PLATEN may be specified, but are not necessary. 

VPC indicates that the Vertical Forms Control 
(hardware page eject) is available on the ptiysical 
printer. If this option is not ^cified for a 
DPTX SP3270 printer, page ejects in files directed 
to a DPTX supported IBM 3270 printer ty the 
standard Primos spool system will be performed fcy 
successive line feeds, 

PLATEN nnn specifies the platen width in characters. If this 
option is included, the decimal number ram in the 
range from 1 to 255 inclusive must be specified. 
If this option is not included, the printer will 
be assumed to have a platen width of 80 
characters. 
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Sample Ii^hA File 

■The follcwing is a sample input file and the tabular listing file 
produced from it: 

Define Group 
Address 40 
Line 

Protocol SP3270 
Enable Geieral_poll 
Define Device 

Name Support. 1 

Address 40 

Enable Read, Write, Block, Command 

User 32 
Drfine Device 

Nane Support. 2 

Address CI 

Enable Read, Write, Block, Conmand 

User 33 



Line Protocol: SP3270 EBCDIC 

Name Addr Inq Outq Type Enable 



Maxrasg Platen VPC User 



Group Address: 40, General poll 

SUPPORT. 1 40 7 3 Terminal Read Write Block Cmd 

2048 32 

SUPPORT. 2 CI 7 3 Terminal Read Write Block Cnad 

2048 33 



DPPCPG WARNING AND ERROR MESSAGES 

Error and warning messages can be categorized ty their origin: errors 
in the command line parsing or in file systan operations, and those 
caused by violations of the source grammar (or binary data structure 
rules — if the REVERSE option is specified) in the inpit file. 

Conmand line and file system errors are fairly simple, and the error 
messages are very dear. As these error messages are generated more ty 
the operating syston than they are ty DPTCPG, this document will not 
attanpt to describe them. For further information on these errors, the 
reader is referred to The Prime User's Guide IDR 4130, 

Conmand line syntax violations result in messages describing the 
correct command syntax, and /termination of the program. No output 
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files are created, nor is the input file affected. 

File systan errors encountered while processing results in an immediate 
termination of the program. Furthermore, any output files that have 
been created as a result of the invocation of DPTCFG are deleted. Ohe 
input file is unaffected. 

Any type of error inhibits the output of the DISHiA^ or LISTING 
options. 



Source Input File Errors 

DPTCFG produces only two severity levels: warning and error. Warnings 
are caused either fcy re^mdant option specifications for a group or 
device, or by conflicting device and/or group numbering in the source 
statements. Group and device nuitiiering is to be considered obsolete 
henceforth for the reasons given under Compatibility with Previous 
Revs, below. Other than producing warning messages, DPTCFG ignores 
numbering conflicts and produces the output specified. 

Errors are caused by conflicting or missing information in the source 
statements which cannot be supplied or resolved by DPTCFG, No output 
files are produced (with the exception of the ERROR file — if 
requested) . 

Warning Messages 

Here are the warning messages in alphabetical order. When a ward in a 
message is entirely capitalized, as "GROUP", it refers specifically to 
a keyword, or its arguments. When only the first letter is 
capitalized, as "Group", a more general meaning is intended. 

DPTCFG maintains its own internal count of devices and groups. Ohe 
d^rioe and group numbers to which most warning messages refer are 
obsolete. When the user specifies a group or device number, or the 
numbers of the devices within a group incorrectly, DPTCFG flags the 
occurrence with a warning message, o IXWICE count of previous group 
incorrect. 

The number of devices inferred from the DEVICE nm, m specifier of the 
DEFINE GROUP statement differed from the actual number of device 
definitions for this graap. 



• Device number out of sequence/range. 

In the DEFINE lEVICE rn statanent, the device number nn is not that 
ejected. 



• First (tevice number out of sequence. 
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In the DEVICE ram, m specifier of the EEFINE GRCDP statement, the 
number of the first device (nn ) is either less or greater than the next 
nuE±)er in sequence. 



• Graip number out of sequence. 

The group number given in the I»!FINE GROUP statement is oat of 
sequence. 



• Last device in Group out of sequence. 

In the DEVICE rm,- nm specifier in the HIFINE GRCUP statement, ran is 
less than the current count of devices alrea^ defined. 



• More devices than defined in GROUP. 

In the DEFINE GROUP statanent, the DEVICE nn,nim specifier mm did not 
match DPTCPG's internal count of the devices specified when tiEe end of 
that group definition was reached. 



• Redundant <option> specification. 

The user has specified some option twice (e.g.: given two addresses 
for a group) . The second and all subsequent re-specifications are 
ignored, option m^ be one of the following: 

For groups: 

ADDRESS 

DEVICE (obsolete) 

LINE 

PROOXXXJL 

For devices: 

ADDRESS 

ENABLE: COyiMAND | BLOCK | WRITE | READ 

NAME 

PRINTER HiATEN 

PRINTER VPC 

USER 

If a warning message is generated that indicates trouble with the 
following device keywords, INPUTQ, MAXMSG, or OUTPtlTQ contact your 
Prime System Analyst. 
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Error Messages 

Error messages come from two scxirces, those resulting from conflicts in 
the syntax of the source statonents and those resulting from conflicts 
in the information given, or from insufficient information, DPTCEXS's 
error messages are as follows: 

• ADDEIESS missihg in previous Device definition. 
The user did not specify an address for the device. 

• MDRESS missing in previous Group definition. 
As above, but for a group, 

• Address already used in Group, 

OVo devices in the same group have the same address. Note that this 
may result from a bad EEFINE GPOJP statonent. 

• Address already used on line, 

IWo groups, defined to be on the same line, have the same address, 

• Duplicate USER id. 

TWO DEFINE ISIVICE statements specified the same user number for a 
command terminal (USER m option) , 

• Duplicate name in configuration, 

A previous DEFINE EEVICE Statement provided the identical {ignoring 
case) device name as the current DEFINE OSVICE statement. Device names 
must be unique, 

• ENABLE CX*IMfiND illegal on printer. 

The current DEFINE lEVICE statement specified that the devics is a 
printer and that it is a user (ERIMDS) terminal. These two options are 
mutually exclusive. 
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• ENISLE GENERiUL_BaLL illegal under M3270 protocol, 
or 

• GROUP ENABLE GENERfiT^KSLL illegal for non SP3270. 

The ENABLE GENERAL_K3LL option is legal only for SP3270 groups. 
(EM3270 groups must always accept general polls.) 

• Heterogeneous protocol on line, 

OVo ISS'INE GRCUP statements conflict in their definition of the line 
protocol. SP3270 and EM3270 cannot exist simultaneously on the same 
line. 



• LINE missing in previous Group definition. 

In the previous DEFINE GROUP statement, the mandatory LINE n clause was 
emitted. 



• Missing: [<keywQrd>|<object value>] 

The file is incomplete. A keyword option (for example the user number 
in the USER clause) , or possibly a EEFINE EEVICE statacient for a group 
is missing. 



• NAME missing in previous Device definition. 

The mandatory NAME clause was missing from the previais DEFINE DEVICE 
statattent. 



• Noi 3271 address. 

The value specified in the ADDRESS clause of a DEFINE DEVICE or 
EEFINE GROUP statement is not a legal 3271 address. (This address must 
be ejqpressed in hexadecimal.) The "IBM 3270 Information Display System 
Component Description" manual (GA27-2749) provides a list of valid 
control unit and device addresses. 



• Printer platen length too large. 

The platen length specified must not exceed 255 characters. 

• EROTOCQL missing in previous Grcwp definition. 

The user did not include the mandatory HiCTOOCJL clause in the 
DEFINE GROUP statonent, 
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• Unexpected source_lit:eral . 
Expecting: [keyword [ object identifier 

• ... keyword I object identifier ] 

Has indicates that the user either omitted some keyword or object, or 
did not correctly specif the dDject. Specifying two numbers where one 
is required, or speciJ^ing a group's protocol as other than SP3270 or 
EM3270 are two examples. 



• USER and EWffiLE OOWIAND illegal on printer. 

The USER and IRINTER clauses were specified in the same DEFINE EEVICE 
statement. The grammar defines these two to be mutually exclusive. A 
printer is not a user terminal. 

• USER illegal on printer. 

The same as above, (The difference being the order in which the two 
clauses were specified.) 

• USER missing in previous Device definition. 

The GCMMRND c^ion in the ENABLE clause of a ISIFINE KWICE statement 
was specified, but the corresponding USER clause was missing. 

Binary Inp± File Errors 

When the REVH^SE option is specified, the input file is ej^scted to be 
a binary file produced ty a previous invocation of DPTCFG. There is 
only one error message associated this case, "Bad Coifig file format." 
which indicates that the binary input file that the user specified 
contains inconsistent information (according to the structure 
established for DPTCFG) . No further inf oritation is given, as it is 
assumed that the user should be editing only source files, and 
therefore the file in question cannot be a compatible DPTCFG binary 
file. 



CX»!PATIBIL3Ty WTEH PREVIOUS REVS 

Previous Revisions of EPTCPG differed somewhat from the current 
product. In the older version, the default output filename was DPTCX»3. 
This was changed to conform to the recently established f ilenaming 
standard, and to make the inplonentation of the reverse compilation 
easier. The default output filename is now determined from the input 
filename (not the treename, but merely the filename) . 

The format of the source file statanents has changed somewhat, although 
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DPTCFG will Still correctly process files created for the old compiler. 
The old compiler required keywords (as defined in the section on Source 
Irp± File Grammar) to be prefaced by a hyphen ("-"). This is no 
longer required, and the presence of such on keywords is ignored. 

Ihe device and group numbers have been eliminated, Ihese too are 
recognized by the current compiler and although they are checked for 
syntax and correct values, they are largely ignored. 

In ranoving the requiranent in DPTCEX3 for ordering the groups fcy 
protocol in the input source file, it was necessary to jwt the ordering 
process in the compiler itself, as the binary output file (currently) 
MJSt have this ordering. The group numbers and device numbers are 
therefore somewhat irrelevant, and are not preserved. 

This does mean that the device number returned in a BD$ATT call (see 
the Block Device Interface section of this document) mav not have anv 
discernible relationship to the device number specified in the 
configuration. (Although the source and display files produced by 
DPTCPG will have this ordering.) As the original design of the 
interface intended that users reference a particular device only fcy its 
name and seme label defined ty the interface itself, this is not seen 
to be a significant hindrance. 

Also as a result of renoving the ordering requirement frciti the source 
file (as described above) , the ISVICE keyword of the DEFINE GRCUP 
statonent became superfluous. Ag^n, it will still be recognized by 
DPTCPG, but it is no longer a required entry in a group description. 

Violations of the old DPTCPG granmar that relate to group and device 
numbers result in warnings, but no fatal errors. 

Error and warning message reporting has changed significantly, mostly 
as a result of the separation of the reporting function frcm the 
parsing and syntax checking. The new format should provide equivalent 
functionalily. 



Old DPTCFG Source Files 

It is suggested that users of the old DPTCFG remove the device and 
group numbering frcm their configuration source files and re-compile 
them. This will save considerable effort should support for device and 
group numbering be discontinued at seme future date. 



DPTX STARTUP 

Process Priorities Automatically Set 

The information here affects page 4-9 of The Distributed Processing 
Terminal Executive Guide, IDR4035. 
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At Rev 18.2, BSCMAN (started up ty Hi sySTM>PH_psC) autanatically sets 
its priority to 3. EM3270 and m3270 (started up fcy PH SYSTffl>PH_Mn 
and PH SYSTEM>PH_TM) automatically set their priorities to 2. The 
system operator need not change the priorities of these DPTX processes. 

Autonatic Line Assigmnent 

The information below supplanents page 4-^9. 

Previously to Rev 18.2, the coratnand file SYSTEM>PHLBSC contained 
statonents to assign the synchrcaious lines used ty DPTX at a particular 
installation. As shipped, PH_BSC had statements to assign synchronous 
lines 00 through 03 to the BSCMfiN process. 

At Rev 18.2 DPTX, the assignment of synchronous lines is done 
autanatically, based upon the DPTX configuration established for each 
of the DFPX processes. Thus, if PR_Hyi4 is brought up, BSCMM will 
(^namically assign synchronous lir« 4. 



WARM STARTING DPTX 

As Of Rev 18.2, DPTX automatically recovers from a ^RI^DS warm start. 
When a warm start occurs, the MDLC controller is reset ty the Master 
aear operation, and BSCMRN disconnects all DPTX processes associated 
with it. Eadi of these various DPTX processes will tiien autanatically 
reconnect with BSCMfiN. During this time, which may be as much as a few 
minutes, host oomrauncation (for DSC and TCP) and control unit 
oomrnunication (TSF and TCP) is tonporarily interrupted. Both the IBM 
host and the control unit should tolerate such an interruption. 
However, transactions which were incomplete are the application 
programs' responsiblity to recover. The output log of each DPTX 
process will indicate when a warm start has occurred. 

DPTX at Rev 17 .8 has a partial warm start restart capability in that 
the system need not be cold started to restart BSCMfiN. For Rev 17.8, 
after a warm start has occurred, a DPTX -OFF, then DPTX -CN should be 
done. 



MULTILINE TOAFFIC MANflSER 

This section describes the parameters which are supplied to the 
DPTX-TSF Traffic Manager at initialization and sane subtle interactions 
between than which may affect syston performance in unsuspected w^s. 
1M3270 is used only in the DPTX-TSF and DPTX-TCF products, not 
DPTX-DSC. These notes result from laboratory ejiperience, and will 
undoubtedly be amended as that ej^jerience increases. Ihese comments 
are specific to Rev 18.2 (and later) DPTX. 
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Introduction 

Several paraneters are provided at initialization time to control 
polling and recovery rates for configured devices and control units. 

These parameters are usually provided in the command file used to 
startup the Traffic Manager phantan (sometimes referred to as OM or the 
sm process) . Should m be started f rem a user terminal (a practice 
which is not encouraged, as this rarely provides any useful 
information, and then only in the debugging process) , the user is 
prompted for this information. 

The information required is: 

• Line recovery delay. Sometimes, due to excessive line flutter, 1M 
"shuts" down a line — the line is deconf igured, and both the 
receiver and transmitter are turned off at the hardware level. 
Periodically, OM will attempt to recover the line by reconfiguring 
it. This 6ela^ time specifies the period between the time the line 
is deconf igured and the time recovery is initiated. 

• Control Unit recovery delay. When a protocol violation ty a 
control unit occurs, TM ceases to poll that unit for this period of 
time. The actual delay time between a protocol violation and 
re-activation of traffic to and from a CU is of course dependent on 
whether the line is active or in recovery (in which case the line 
recovery del^ — above — has an effect) . 

• Device recovery delay. When a device status indicates that it is 
nonoperational due to some hardware failure, TM ceases to direct 
traffic (specific polls and selects) to that device. This also 
occurs when a time-out occurs on a specific poll or device select. 
IHne delay specified is the maximum period between the time OM 
"marks the .device down" and the time recovery (resumption of 
specific polling and device selection) occurs. The actual time 
will vary, depending on the line and CU recovery delays (if 
relevant) and whether a device status indicating that the device is 
operational is received during a general poll to the corresponding 
CU. 

• Specific polling period for devices attached to a CU for v*iich 
general polling is not enabled. The period specified is the 
minimum period between specific polls to a particular device. 

• General polling interval. The period specified is the maximum 
period between general polls to a particular OI for which general 
polling has been enabled. 

• Specific polling interval for devices attached to a CU for which 
general polling has been enabled. For such control units, it is 
occasionally useful to determine the status of a specific ^vice, 
particularly viien there has been no recent traffic to it. 
/^licable instances include p:inters which are in the midst of 
printing; should there be some medianical failure, the user 
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process could not otherwise be notified of it, TM therefore 
performs periodic specific polling of each device on such a OJ. 

The recovery del^s (in seconds) are specified first (all on one 
configuration line), followed by the polling intervals (in tenths of 
seconds, on the following configuration line) . 

Suggested values 

Users will have to derive their own optimal parameters through trial 
and observation. "This is because DPTX configurations and user 
requiranents vary. Ote following dDservations should help users to 
determine their own optimal valiKS. 

• Recovery delays should be significantly larger than the minimum 
polling interval (an order of magnitude should be sufficient) , 

• The relative ordering of recovery del^s ^ould be as follows: 

The line recovery delay should be the shortest. 

The group recovery delay ^ould be a few times longer tiian the 
line recovery dela^. 

The device recovery del^ should exceed the group recovery 
delay, although it need not be any large multiple (1.5 to 2.0 
should be adequate) . 

• Polling intervals will have a significant effect on response time 
for simple tasks. Caution is advised when decreasing these 
paraneters, as extremely small polling intervals will result in 
correspondingly higher line and HRIME CPU overhead. 

• Polling intervals should adhere to the following ordering: 

The general polling interval should be the anallest (on the 
close order of 0.3 to 1.5 seconds). 

The specific polling interval for use when general polling is 
enabled should be at least an order of magnitude larger than 
the general polling interval. Specific polling under these 
circumstances only serves to determine when devices, such as 
printers, which have been busy become available. Specific 
polling in this circumstance is important, but it need not be 
frequent. 

The specific polling interval for use when general polling is 
inhibited should be approximately the same as the general 
polling interval, possibly somewhat smaller. When ^ecific 
polling is used, the terminal system response time is 
inevitably increased, \*ich irrplies a correspondingly shorter 
polling interval, however greatly reduced polling intervals 
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result in greatly increased overhead. As a "rule of thunto", 
c»ie might take the required response time and divide it ty the 
total number of specific-polled terminals on a line, to get 
seme feel for the minimum specific polling interval. This rule 
usually results in intervals which are highly skewed toward 
high-overhead. {It is probably better to enable general 
polling wherever possible. The only disadvantage is the loss 
of the TEST REQUEST key at the affected terminals.) 

An Example 

The environment is exclusively general-polling (that is, all SP3270 
control units in the configuration have general polling enabled) and a 
relatively large number of devices (printers and terminals) are spread 
over a small number of control units. Previous e^^rience with the 
configuration (both physical and logical) has indicated a high mean 
time between failure (MTBF) for everything except the printers. 

Line, control unit and device recovery times (seconds) : 
1, 2, 12 

The (fetermining factor here is that the printers break down (jam) 
fairly frequently. The 12 seconds chosen as the device recovery time 
^ould provide for a fairly timely re-activation when the local 
operator has corrected the problon. The line recovery time was chosen 
mostly to insure that recovery attempts occurred in a period fairly 
dose to the time specified. 

Specific polling (without general polling), general polling, and 
specific polling (with general polling) intervals (tenths of seconds) : 

1800, 5, 100 

Once again, the low MTBF for printers was the determining factor. As 
all control units have been configured for general polling, the 
specific polling rate for non-general-polled control units is 
irrelevant. The general polling interval is set fairly low, to yield a 
short response time. The specific polling interval for devices on 
control units which have general polling enabled is set to ten seconds 
to insure a timely determination of the status of a "down" or recently 
reactivated device (printer) . 

Another Example 

The environment is the same as the same as the above, except that the 
modems on the lines have an extremely low MTOF and the total Prime 
systan is usually moderately to heavily loaded. 

Line, control unit and device recovery times (seconds) : 
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20, 60r 60 



As might be expected, the unreliability of the lines is the dominant 
factor. To avoid esacessive traffic on the line and excessive CPU 
overhead, the line recovery del^ is set to a relatively large value. 
Ihe CU time is also fairly large, partially as a result of the large 
line recovery time and partially because sane modem failures appear (to 
DPTX) as CU failures (time-outs for examjae) , The device recovery time 
is set to track the CU recovery period. 

Specific polling (without general polling), general polling and 
specific polling (vdth general polling) intervals (tenths of seconds) : 

1800, 20, 100 

The general polling interval was increased here to decrease the CPU 
overhead somewhat, at some sacrifice in response time. 



Ctoserved Interactions 



When a control unit cc device repeatedly times out, the specific 
polling rate becomes strongly affected ty the device and control 
unit recovery periods. If these recovery delays are significantly 
shorter than the specific polling period, the polling period may 
well decrease due to the recovery algorithm, Coiversely, if the 
recovery delays are significantly longer, polling to the particular 
CU/device will not resume for some time, and the perceived polling 
rate will significantly decrease. 

Extranely low polling periods (0 for example) ra^ result in a 
preponderance of polling on the line as compared to the 
transmission of output (user process generated text) . 
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